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Android 是 一 个 优秀 的 开源 手机 平台 ,本 书 由浅 入 深 地 介绍 了 Android 应 用 程序 开发 的 方法 和 技 
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Android 是 谷歌 (Google) 发 布 的 一 个 开放 源 代 码 的 手机 平台 ， 
由 Linux 内 核 、 中 间 件 、 应 用 程序 框架 和 应 用 软件 组 成 ,是 第 一 个 可 
以 完全 定制 ,免费 、 开 放 的 手机 平台 。Android 不 仅 能 够 在 智能 手机 
中 使 用 ,还 可 以 用 在 平板 电脑 .移动 互联 网 终端 上 网 笔记 本 、 便 扒 
式 媒 体 播放 器 和 电视 等 电子 设备 上 。 

Android 在 诞生 之 日 起 便 受 到 广泛 的 关注 ,宏达电 (HTC)、LG、 
三 星 、 摩 托 罗 拉 、 索 尼 爱 立信 、 宏 其 、 华 硕 和 联想 已 经 推出 多 款 
Android 手机 。Android 系统 以 44.8% 的 市 场 份 额 在 美国 智能 手机 
市 场 排名 第 一 ,Android 平板 电脑 的 市 场 份额 为 27%, 且 这 个 数字 
还 在 持续 增加 。 目 前 ,每 天 有 55 万 台 Android 设备 被 激活 ,激活 设 
备 的 总 数 已 达到 2 亿 台 。 

随 着 Android 4.0 版 本 的 公布 ,Android 系统 迎 来 了 全 新 的 时 
代 。Android 4. 0 同时 支持 智能 手机 和 平板 电脑 ,开发 人 员 不 需要 
针对 不 同 屏幕 尺寸 开发 多 个 版 本 的 软件 。 以 前 只 能 用 于 大 屏幕 设 
备 的 界面 开发 技巧 ,也 可 以 平滑 地 引入 智能 手机 的 界面 开发 中 。 

本 书 基于 Android 4. 0 版 本 ,全 面 而 详细 地 介绍 了 Android 应 
用 程序 开发 所 涉及 的 各 个 方面 的 内 容 ,包括 集成 开发 环境 搭建 .用 
户 界面 设计 、 后 台 服 务 开发 .数据 存储 、 组 件 通 信 、 地 图 应 用 、Widget 
和 Android NDK 等 内 容 。 系 统 地 介绍 了 Android 的 各 种 特性 ,将 
Android 系统 的 优越 之 处 展现 在 读者 面前 ,通过 每 章 的 内 容 逐 渐 引 
领 读者 进入 Android 世界 。 

全 书 内 容 包 括 : 

第 1 章 介绍 了 Android 平台 的 起 源 、 发 展 . 特 征 和 体系 结构 ,并 
对 主流 的 手机 操作 系统 进行 了 简单 的 介绍 。 

第 2 章 详细 说 明了 Android 开发 环境 的 安装 与 配置 方法 ,并 对 
部 分 开发 和 调试 工具 进行 了 简单 的 介绍 。 

第 3 章 介绍 了 基于 Eclipse 开发 Android 应 用 程序 的 基础 知识 
和 基本 方法 ,详细 说 明了 Android 工程 文件 的 结构 和 用 途 ,并 介绍 
了 使 用 命令 行 开发 安装 和 运行 Android 应 用 程序 的 方法 。 
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第 4 章 介绍 了 Android 程序 的 生命 周期 和 进程 优先 级 的 变更 方式 ,并 以 Activity 为 
例 说 明 Android 组 件 生命 周期 的 状态 转换 和 事件 回调 函数 的 调用 顺序 ,最 后 简单 介绍 了 
Android 调试 工具 的 使 用 方法 。 

第 5 章 介 绍 了 Android 用 户 界面 的 开发 方法 ,重点 介绍 了 常见 的 界面 控件 ,界面 布 
局 、 操 作 栏 .Fragment、 莱 单 和 界面 事件 的 使 用 方法 。 

第 6 章 介 绍 了 Android 系统 的 组 件 通信 机 制 , 其 中 包括 使 用 Intent 启动 组 件 的 原理 
和 方法 ,Intent 过 滤器 的 原理 与 匹配 机 制 , 以 及 广播 消息 的 接收 和 发 送 方法 等 。 

第 7 章 介绍 了 Android 系统 的 后 台 服 务 组 件 Service, 内 容 包 括 Service 的 原理 和 用 途 ， 
Service 的 启动 和 绑 定 ,AIDL 语言 定义 跨 进 程 服务 的 接口 ,以 及 线程 使 用 和 跨 线程 界面 
更 新 。 

第 8 章 介绍 了 Android 系统 所 提供 的 多 种 数据 存储 方法 ,其 中 包括 易于 使 用 的 
SharedPreferences、 经 典 的 文件 存储 和 轻 量 级 的 SQLite 数据 库 , 最 后 介绍 了 Android € 
统 应 用 程序 间 的 数据 共享 接口 ContentProvider。 

第 9 章 介 绍 了 位 置 服务 的 概念 和 位 置信 息 获 取 方 法 ,简单 说 明了 Google 地 图 密 钥 的 申 
请 方法 ,重点 介绍 了 Google 地 图 中 的 MapView、MapController 和 Overlay 的 使 用 方法 。 

第 10 章 介 绍 了 Widget 的 开发 方法 ,详细 讲解 了 Widget 的 设计 原则 和 开发 步骤 ,说 
明了 Widget 的 配置 方法 ,以 及 使 用 Service 更 新 Widget 的 技巧 。 

第 11 章 介绍 了 Android 系统 中 使 用 C/C++ 本 地 代码 进行 程序 开发 的 方法 ,并 说 明 
了 Android NDK 的 用 途 和 优 缺点 ,本 地 代码 的 开发 和 编译 环境 ,以 及 与 CPU 指令 集 相 
关 的 开发 示例 。 

第 12 章 以 “天 气 预 报 软件 ”为 例 ,介绍 了 Android 应 用 程序 开发 过 程 中 的 需求 分 析 、 
界面 设计 、 模 块 设 计 和 程序 开发 等 步骤 ,并 简单 介绍 了 Android 应 用 程序 的 设计 和 开发 
的 思路 与 方法 。 

本 书 由 哈尔滨 工程 大 学 王 向 辉 和 张 国 印 、 哈 尔 滨 理工 大 学 赖 明珠 负责 主要 编写 工 
作 。 其 中 , 王 向 辉 编写 第 1 一 第 6 章 , 张 国 印 编写 第 7、 第 9 和 第 12 章 , 赖 明珠 撰写 第 8、 
第 10 和 第 11 章 。 同 时 和 参与 本 书 编写 工作 的 还 有 丛 岩 青 、 杜 婧 、 徐 子 涵 、 匈 新 、 马 书 亮 、 张 
灿 岩 、 张 弘 \ 王 建立 、 李 茵 婷 、 周 维 、 郭 轶 、 赵 乙 东 、 张 洪 浩 、 李 展 星 , 这 里 对 他 们 的 辛苦 工作 
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在 本 书 的 编写 过 程 中 ,得 到 黑龙 江 省 电子 信息 产品 监督 检验 院 王 希 忠 院 长 的 热情 帮 
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Android 是 一 个 发 展 迅速 的 手机 平台 ,很 多 方面 还 在 不 断 完善 和 变化 。 由 于 能 力 和 
水 平 所 限 ,虽然 竭尽 全 力 ,但 仍然 难免 存在 错误 和 下 漏 的 地 方 ,希望 各 位 专家 、 老 师 和 同 
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live. cn。 本 书 的 示例 代码 和 电子 课件 可 以 在 http://android. hrbeu. edu. cn 或 清华 大 学 
出 版 社 网 站 http://www. tup. tsinghua. edu. cn 下 载 。 


编 者 
2012 年 3 月 于 哈尔滨 工程 大 学 


-b- 


HiS Android I occa RO RD Roe rti renis 


1.1 JGELBMEZ BE mmm mm mene 
1.2 Android Elec enne een ten tts 
1.2.1. JPACEEIBEBE enn 
1:2:2 Android JE eeseceseesteese eese es eaae es 
下 
de 


第 2 章 Android JF ERIS eee 


2.1 5E Android 开发 环境 eene 


2.1.1 安装 JDK fil Eclipse 


2.1.2. 安装 Android SDK ee 
20» Aado SI. 2:22:22: 2 ciam asd eta na stan EESE 


2.2.2 示例 程序 


第 3 章 第 一 个 Android 程序 pp 


3.1 第 一 个 Android 程序 MI 
3.2 Android 程序 结构 n 0L ZA LA 


N 


CA 2 版 ) 


a 


a 


a 


rad 生命 周期 ae ii 


程序 生命 周期 Sentent qakeb t tpsctonemietiae sad bodies di 
Android 组 件 和 
Activity 生命 周期 «eH 
程序 调试 

4.4.1 LogCat 
4.4.2 DevTools sees 


Android 用 户 界 面 .74 


界面 控件 
TextView 和 EditText 


1 

2 Button 和 ImageButton +e eee 
3 CheckBox ffl RadioButton 
4 Spinner 
5 
6 


'abbost Sri 
面 布局 
2 框架 布局 ， 


P) po po go Do do 


A UySDOnhDSP"amnnsr»nm»;tm 
Oo c 


.4.3 子 菜单 
操作 栏 与 Fragment ee 112 
5.5.1 操作 栏 …… ie 

5.5.2 Fragment «HH 115 
5.5.3 Tab 导航 栏 19 


en cocco 


7.3 


8.2 


8.3 


8.4 


5.6.2 触摸 事件 


iD rar f. MM 


Intent 简介 «e HH HH 


6.1.1 启动 Activity 
6.1.2 获取 Activity 返回 值 


Intent 过 滤器 MEREATUR MERI DERE TRUE R NM 
广播 消息 


= ipaa ri 


Service fü] dp sn HH HH nnnm nne 
本 地 服务 CTT 


7.2.1 服务 管理 
7.2.2 使 用 线程 
7.2.3 服务 绑 定 


远程 服务 ee HH HH HH Hn 


7.3.1 进程 间 通 信 eee 
7.3.2 服务 创建 与 调用 
7.3.3 数据 传递 “.………: 


EAA Ae o EE EE EEE 
a PEDE 


8.1.1 SharedPreferences 
8.1.2 示例 


aaa EAT EE WEE E EE ee 


8.2.1 内 部 存储 … 
8.2.2 外 部 存储 … 
8.2.3 资源 文件 


数据 库存 储 HH HH nmn 
8.3.1 SQLite 数据库 ee 


8. 3.2 手动 建 库 
8.3.3 代码 建 库 
8.3.4 数据 操作 


数据 共享 E 


195 


M 


CA 2 版 ) 


8.4.1 ContentProvider ee 208 


oa EDAD eoi aea ides Biabitqiieqin JU 


Google 地 图 应 用 «me 232 
9.2.2 使 用 Google 地 图 «mmm mH 233 
LEA EE T 23 0: 13 BORED 


Widget 简介 42 
Widget 5j Service «He 25 


Android NDK JF JR. neret eerte reete ee eser 250 


NDK füjfp s HH 259 
NDK 初级 示例 … 
NDK 高 级 示例 = 


程序 设计 €—— 
12.2.1 用 户 界面 设计 eene 275 
12.2.2 PURPER eee tre teer ene eii ERR eer inis 216 


12. 3 


习题 
附录 A 
附录 B 
附录 CC 
附录 D 


12.2.3 程序 模块 设计 
程序 开发 

12.3.1 工程 结构 
12.3.2 数据 库 适 配器 
12.3.3 短信 监听 器 
12.3.4 后 台 服 务 


ADB 命令 eeererrerrturrirttnriretettstterrt ertett 
AndroidManifest ZF eene 


e 
… 278 
+ 278 
… 280 
284 
86 

AAE a T E A iiit E tete DOOR ORO E EEA 
NS exl aei ex aikanani - 301 
Android 虚拟 设备 pe 


294 


302 


305 


308 


310 


第 工 章 — 


Android 简介 


Android 是 一 个 优秀 的 开源 手机 平台 ,通过 本 章 的 学 习 可 以 让 读者 对 Android 平台 的 起 
源 发展. 特征 和 体系 结构 有 个 初步 的 了 解 , 并 通过 比较 Windows Phone 7, PalmOS, X 3$ 
Symbian 和 iOS 等 目前 主流 的 手机 操作 系统 ,充分 理解 Android 平台 的 优势 和 不 足 。 

本 章 学 习 目 标 : 

。 了 解 各 种 手机 操作 系统 的 特点 

。 了 解 开 放手 机 联盟 的 目的 、 性 质 和 组 成 ; 

* 了解 Android 平台 的 发 展 历史 ; 

。 掌握 Android 平台 的 特征 ; 

。 掌握 Android 平台 的 体系 结构 。 


11 手机 操作 系统 


在 早期 的 手机 内 部 是 没有 智能 操作 系统 的 ,所 有 的 软件 都 是 由 手机 生产 商 在 设计 时 
所 定制 的 ,因此 手机 在 设计 完成 后 基本 是 没有 扩展 功能 的 。 后 期 的 手机 为 了 提高 手机 的 
可 扩展 性 ,使 用 了 专 为 移动 设备 开发 的 操作 系统 ,使 用 者 可 以 根据 需要 安装 不 同类 型 的 
软件 。 虽 然 使 用 操作 系统 的 手机 具有 更 好 的 可 扩展 性 ,但 由 于 操作 系统 对 于 手机 的 硬件 
配置 要 求 较 高 ,所 产生 的 硬件 成 本 和 操作 系统 成 本 使 手机 的 售 价 明 显 高 于 不 使 用 操作 系 
统 的 手机 ,因此 一 般 只 有 在 高 端 智能 手机 上 使 用 手机 操作 系统 。 

目前 ,手机 上 的 操作 系统 主要 包括 以 下 几 种 ,分 别 是 Android; iOS, Windows 
Mobile, Windows Phone 7 ,Symbian, f$ , PalmOS 和 Linux, 


1. Android 


Android 是 谷歌 (Google) 公 司 发 布 的 基于 Linux 的 开源 手机 平台 ,该 平台 由 操作 系 
统 . 中 间 件 和 应 用 软件 组 成 ,是 第 一 个 可 以 完全 定制 .免费 .开放 的 手机 平台 。Android 是 
一 个 完全 免费 的 手机 平台 ,使 用 Android 并 不 需要 授权 费 , 而 且 因 为 Android 平台 有 让 
富 的 应 用 程序 ,也 大 幅度 降低 了 应 用 程序 的 开发 费用 ,可 以 节约 15% 一 20% 的 手机 制造 
成 本 。Android 底层 使 用 开源 的 Linux 操作 系统 ,同时 开放 了 应 用 程序 开发 工具 ,使 所 有 
程序 开发 人 员 都 在 统一 、 开 放 的 开发 平台 上 进行 开发 ,保证 了 Android 应 用 程序 的 可 移 
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HE, Android 平台 使 用 Java 语言 进行 开发 ,支持 SQLite 数据 库 .2D/3D 图 形 加 速 、 多 
媒体 播放 和 摄像 头等 硬件 设备 ,并 内 置 了 丰富 的 应 用 程序 ,如 电子 邮件 客户 端 .闹钟 、 
Web 浏览 器 .计时 器 .通讯 录 和 MP3 播放 器 等 。Android 界面 如 图 1. 1 所 示 。 


2. iOS 


iOS 是 由 苹果 公司 开发 的 操作 系统 ,以 开放 源 代码 的 操作 系统 Darwin 为 基础 ,主要 是 
供 苹果 公司 生产 的 iPhone.iPod touch,\iPad 以 及 Apple TV 使 用 。iOS 的 系统 架构 分 为 4 个 
层次 ,分 别 是 核心 操作 系统 层 ,核心 服务 层 、 媒 体 层 和 可 轻 触 层 。 为 了 便于 应 用 程序 开发 , 苹 
果 公 司 提供 了 SDK ,为 iOS 应 用 程序 进行 开发 ,测试 .运行 和 调试 提供 工具 。 多 点 触摸 操作 
是 iOS 的 用 户 界面 基础 ,也 是 OS 区 别 于 其 他 手机 操作 系统 的 特性 之 一 。 此 外 ,iOS 还 通过 
支持 内 置 加速 器 ,允许 系统 界面 根据 屏幕 的 方向 而 改变 方向 。iOS 自 带 大 量 的 应 用 程序 , 包 
括 SMS 简讯 日历 .照片 .相机 、YouTube 股市. 地图、 和 天气、 时间、 计算机、 备忘录、 系统 设 
定 iTunes 和 通讯 录 等 。 

iOS 界面 如 图 1. 2 所 示 。 


图 1.1 Android 界面 图 1.2 iOS 界面 


3. Windows Mobile 


Windows Mobile 是 微软 公司 推出 的 移动 设备 操作 系统 , 拥 绑 了 一 系列 针对 移动 设 
备 而 开发 的 应 用 软件 ,这 些 软件 构建 在 Microsoft Win32 API 基础 之 上 ,可 以 播放 音 视频 
文件 .浏览 网 页 .MSN 聊天 和 收发 电子 邮件 。 由 于 该 操作 系统 对 硬件 配置 要 求 较 高 ,一 
般 需 要 使 用 高 主 频 的 嵌入 式 处 理 器 ,从 而 产生 了 耗 电 量 大 .电池 续航 时 间 短 和 硬件 成 本 
高 等 缺点 。Windows Mobile 系列 操作 系统 包括 Pocket PC、Smartphone 和 Portable 
Media Center, Smartphone 提供 的 功能 侧重 点 在 电话 方面 ,主要 支持 的 功能 有 电话 、 电 
子 邮件 、 联 系 人 和 即时 消息 等 。Pocket PC 的 功能 侧重 个 人 事务 处 理 和 简单 的 娱乐 ,主要 
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支持 的 功能 有 日 程 安排 .移动 版 Office 和 多 媒体 播放 功能 等 。Portable Media Center 提 
供 的 功能 侧重 点 在 移动 多 媒体 功能 ,主要 支持 音频 播放 和 视频 播放 等 。Windows Mobile 
的 最 新 版 本 是 2010 年 2 月 2 日 发 布 的 6.5.3 版 ,因为 mpm 

Windows Phone 7 的 出 现 , Windows Mobile 正 逐 渐 退 出 e EIL. Nm 


Hi t$ 台 o @ Getting Started 
Windows Mobile 界面 如 图 1. 3 所 示 。 


4. Windows Phone 7 


Windows Phone 7 是 微软 2010 年 10 月 发 行 的 新 一 
代 移 动 操作 系统 ,具有 独特 的 “ 方 格子 ”用 户 界面 ,增加 了 
多 点 触 控 和 动力 感应 功能 ,并 集成 了 Xbox Live 游戏 和 
Zune 音乐 功能 。Windows Phone 7 的 用 户 界面 非常 简 
洁 , 黑 色 背 景 下 的 亮 蓝 色 方 形 图 标 ,显得 十 分 清晰 、 醒 目 ， 1.3. Windows Mobile 界面 
如 图 1.4 所 示 。 界 面 上 直接 提供 了 Xbox Live 游戏 和 社 
交 网 站 的 入 口 ,可见 Windows Phone 7 对 游戏 功能 和 社交 功能 的 重视 。 虽 然 Windows 
Mobile 和 Windows Phone 7 都 是 微软 推出 的 手机 操作 系统 ,但 这 两 个 系统 上 的 应 用 软件 
并 不 互相 兼容 ,因此 为 Windows Mobile 开发 的 软件 并 不 能 直接 在 Windows Phone 7 上 
使 用 。 


5. 黑莓 系统 


黑莓 系统 是 加 拿 大 RIM 公司 推出 的 一 种 移动 操作 系统 ,主要 在 黑莓 手机 上 使 用 ,其 
特色 是 支持 电子 邮件 推送 功能 ,邮件 服务 器 主动 将 收 到 的 邮件 推送 到 用 户 的 手持 设备 
上 ,而 不 需要 用 户 频 繁 地 连接 网 络 查 看 是 否 有 新 邮件 。 同 时 , 黑 苞 系统 提供 手提 电话 、 文 
字 短 信 、 互 联网 传真 网 页 浏览 及 其 他 无 线 信息 服务 功能 。 黑 莓 系统 主要 针对 商务 应 用 ， 
具有 很 高 的 安全 性 和 可 靠 性 。 黑 莓 系统 界面 如 图 1. 5 所 示 。 


mm) e 10:06 


Slideshow To Go 


1.4 Windows Phone 7 界面 1.5 黑莓 系统 界面 
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6. Symbian 系统 


Symbian 是 一 个 实时 多 任务 32 位 操作 系统 ,提供 了 开发 使 用 的 函数 库 .用 户 界面 、 通 
用 工具 和 参考 示例 。Symbian 最 初 由 塞 班 公司 开发 和 维护 ,后 被 诺基亚 收购 。Symbian 
操作 系统 具有 功 耗 低 、 内 存 占 用 少 等 特点 ,适合 手机 等 移动 设备 使 用 ,具有 灵活 的 应 用 界 
面 框架 ,并 提供 公开 的 API 文档 ,不 但 使 开发 人 员 可 以 快速 地 掌握 关键 技术 ,还 可 以 使 手 
机 制造 商 推出 不 同 界面 的 产品 。 早 期 ,Symbian 系统 并 不 对 外 开放 核心 代码 ,核心 代码 
仅 提 供给 手机 制造 商 和 其 他 合作 伙伴 。 后 期 随 着 Android 和 iOS 市 场 占有 率 的 不 断 提 
JE ,诺基亚 曾经 一 度 将 Symbian 系统 开源 ,希望 借 此 改变 Symbian 系统 的 命运 。 因 为 
Symbian 系统 在 架构 、 用 户 体验 和 应 用 程序 数量 等 方面 的 不 足 ,诺基亚 最 终 决 定 放弃 
Symbian 系统 ,与 微软 合作 将 Windows Phone 作为 诺基亚 的 手机 操作 系统 ,而 Symbian 
将 在 一 到 两 年 内 被 Windows Phone 所 取代 。 

Symbiam 界面 如 图 1.6 所 示 。 


7. PalmOS 系统 


PalmOS 是 32 位 的 嵌入 式 操作 系统 ,主要 在 移动 终端 上 使 用 。PalmOSs 由 3Com 公 
司 的 Palm Computing 部 门 开 发 ,拥有 较 多 的 第 三 方 软件 。PalmOS 在 设计 时 考虑 到 了 移 
动 设备 的 内 存 相 对 较 小 ,所 以 操作 系统 本 身 所 占 的 内 存 极 小 ,基于 PalmOS 编写 的 应 用 
程序 所 占 的 空间 也 很 小 。PalmOS 的 操作 界面 采用 触 控 式 ,基本 所 有 的 控制 选项 都 排列 
在 屏幕 上 , 仅 使 用 手写 笔 就 可 以 完成 所 有 操作 。PalmOS 向 用 户 免 费 提 供 了 开发 工具 ,多 
许 用 户 利用 该 工具 编写 或 修改 相关 软件 ,使 支持 PalmOS 的 应 用 程序 丰富 多 彩 。PalmOS 
在 其 他 方面 还 存在 一 些 不 足 , 例 如 自身 不 具有 录音 和 MP3 播放 功能 。 如 果 需 要 使 用 这 
些 功 能 ,还 需要 加 入 第 三 方 软件 或 硬件 设备 方 可 实现 。PalmOS 界面 如 图 1.7 所 示 。 
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1.6 Symbian 界面 1.7 PalmOS 界面 


8. Linux 手机 操作 系统 
Linux 手机 操作 系统 是 由 计算 机 Linux 操作 系统 演变 而 来 的 。Linux 进入 到 移动 终 
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端 操作 系统 以 来 ,以 其 开放 源 代码 的 优势 吸引 了 越 来 越 多 的 终端 厂商 和 运营 商 的 关注 。 因 
为 Linux 开放 源 代 码 的 特性 ,能 够 大 幅度 地 降低 手机 的 软件 成 
本 ,而 且 有 利于 独立 软件 开发 商 开发 出 硬件 利用 效率 高 功能 更 
强大 的 应 用 软件 ,也 便于 行业 用 户 开发 安全 、 可 靠 的 应 用 系统 。 
同时 也 满足 了 手机 制造 商 根据 实际 情况 有 针对 性 地 开发 Linux 
手机 操作 系统 的 要 求 , 又 吸引 了 众多 软件 开发 商 对 内 容 应 用 软件 
的 开发 ,丰富 了 第 三 方 应 用 。 然 而 ,Linux 操作 系统 有 其 先天 的 不 
E. 首先, 入门 难度 高 熟悉 其 开发 环境 的 工程 师 少 、 集 成 开发 环 
境 较 差 ; 其 次 ,由 于 微软 操作 系统 源 代码 的 不 公开 ,基于 Linux 的 
产品 与 个 人 计算 机 的 连接 性 较 差 ;最 后 ,尽管 目前 从 事 Linux 操 
作 系 统 开发 的 公司 数量 较 多 ,但 真正 具有 很 强 开发 实力 的 公司 却 ”图 1.8 Linux 手机 操作 
很 少 ,而 且 这 些 公司 之 间 相 互 独立 开发 ,很 难 实现 更 大 的 技术 突 系统 界面 

破 。Linux 手机 操作 系统 界面 如 图 1. 8 Brzn 


12 Andod 起 源 


说 到 Android 的 起 源 , 首 先 要 介绍 一 下 Android 平台 的 推动 者 OHA(Open Handset 
Alliance, 开 放手 机 联盟 ) ,然后 会 按照 时 间 顺 序 介绍 Android 的 重要 事件 ,包括 Android 
SDK 的 版 本 发 布 .Google 开发 者 大 赛 Android 手机 和 平板 电脑 发 布 等 内 容 。 


121 开放 手机 联盟 


OHA 是 美国 谷歌 公司 于 2007 年 发 起 的 一 个 全 球 性 的 联盟 组 织 , 目 标 是 研发 用 于 移 
动 设备 的 新 技术 ,用 以 大 幅 削 减 移动 设备 开发 与 推广 成 本 。 同 时 通过 联盟 各 个 合作 方 的 
努力 ,在 移动 通信 和 领域 建立 新 的 协作 环境 ,促进 创新 移动 设备 的 开发 ,使 消费 者 的 用 户 体 
验 远 远 超过 今天 的 移动 平台 所 能 享受 到 的 。 

OHA 成 立时 由 34 个 成 员 组 织 构成 ,包括 电信 运营 商 、 半 导体 芯片 商 、 手 机 硬件 制造 
商 、 软 件 厂商 和 商品 化 公司 五 类 ,涵盖 移动 终端 产业 链 各 个 环节 。 目 前 ,OHA 的 成 员 组 
织 数量 已 经 增加 到 82 个 。 谷 歌 通过 与 运营 商 , 设 备 制造 商 、 开 发 商 和 其 他 相关 各 方 结 成 
深层 次 的 合作 伙伴 关系 ,借助 建立 标准 化 、 开 放 式 的 移动 设备 软件 平台 ,在 移动 产业 内 形 
成 一 个 开放 式 的 生态 系统 。 

E OHA 的 组 织 成 员 中 ,电信 运营 商 主要 有 中 国 移动 通信 、KDDI( 日 本 )、NTT 
DoCoMo( H Æ) „Sprint Nextel( 美 国 )、T-Mobile( 美 国 )、Telecom (意大利 ) .中国 联通 、 
SoftBank( 日 本 ) .Telefonica( 西 班 牙 ) 和 Vodafone( 英 国 ) .如 图 1. 9 所 示 。 

中 国 移动 通信 N 
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A — Che O0. SoftBank vodafone 
1.9 电信 运营 商 
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OHA 中 的 半导体 芯片 商 有 Audience( 美 国 )、AKM( 日 本 )、ARM( 英 国 )、Atheros 
Communications( 美 国 ) .Broadcom( 美 国 ) , Intel (€ F) , Marvell 3€ FD nVIDIA (美国 ) , 
Qualcomm 3X F|) , SiRFC3S F8) , Synaptics CX F] ) , ST-Ericsson C$ K AJ, 1 E] A gig H8. ) RIT 
Texas Instruments XE Eg) ,如 图 1. 10 所 示 。 
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图 1.10 半导体 芯片 商 


OHA 中 的 手机 硬件 制造 商 有 Acer( 中 国 台湾 )、 华 硕 ( 中 国 台湾 ).Garmin( 中 国 台 
湾 ) 宏达电 (中 国 台湾 )、.LG( 韩 国 ) 三 星 (韩国 )、 华 为 (中 国 ) 摩托罗拉 (美国 )、 索 尼 爱 
立信 (日 本 和 瑞典 ) 和 东芝 (日 本 ), 如 图 1.11 所 示 。 
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1.11 手机 硬件 制造 商 
OHA 中 的 软件 厂商 有 Ascender Corp (美国 )、eBay (美国 )、 谷 歌 ( 美 国 )、 


LivingImage (日 本 )、NuanceCommunications (美国 )、Myraid (瑞士 )、Omron (日 本 )、 
PacketVideo( 美 国 ) .SkyPop( 美 国 ) .Svox( 瑞 士 ) 和 SONiVOX( 美 国 ) ,如 图 1. 12 所 示 。 
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1.12. 软件 厂商 


OHA 中 的 商品 化 公司 有 Aplix Corporation (日 本 )、Noser Engineering (瑞士 )、 
Borqs( 中 国 )、TAT-The Astonishing (瑞典)、Teleca AB( 瑞 典 ) 和 Wind River( 美 国 ) ,如 
图 1. 13 所 示 。 
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1.13 商品 化 公司 
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2007 年 11 月 5 日 ,开放 手机 联盟 成 立 , 由 电信 运营 商 , 半 导体 芯片 商 \ 手 机 硬件 制造 
商 .软件 厂商 和 商品 化 公司 在 内 的 34 个 组 织 构成 ,推动 
Android 平台 的 研发 和 推广 ,其 徽标 如 图 1. 14 所 示 。 e 


1. Android 1. 0 版 


2007 年 11 月 12 日 ,谷歌 发 布 了 Android SDK 预览 版 ， 
这 是 第 一 个 对 外 公布 的 Android SDK ,为 发 布 正式 版 收集 
用 户 反馈 。 

2008 年 4 月 17 日 .谷歌 举办 总 共 1000 万 美金 的 
Android 开发 者 竞赛 ,奖励 最 有 创意 的 Android 程序 开发 ”图 1.14 开放 手机 联盟 微 标 
者 ,使 Android 平台 在 短 时 间 积 累 了 大 量 优秀 的 应 用 程序 。 
涌现 出 像 cab4me( 出 租车 呼叫 )、BioWallet( 生 物 特征 识别 ) 和 CompareEverywhere( 实 时 
商品 查询 ) 等 极 具 创意 的 应 用 程序 。Android 开发 者 竞赛 作品 如 图 1. 15 所 示 。 


pr 


1.15 Android 开发 者 竞赛 作品 


2008 年 8 月 28 日 ,谷歌 开通 了 Android Market, fl Android 手机 下 载 应 用 程序 ,如 
图 1. 16 所 示 。 程 序 开发 人 员 可 以 将 自己 设计 的 Android 软件 上 传 到 Android Market, 
并 决定 软件 是 否 收取 费用 。 但 在 Android Market 上 销售 软件 需要 向 谷歌 支付 25 美元 的 
注册 费 , 并 在 每 次 交易 中 将 30% 的 利润 支付 给 运营 商 。 

2008 4 9 H 23 日 ,发 布 Android 1.0 版 ,这 是 第 一 个 稳定 的 版 本 。1.0 版 的 SDK 中 
分 别提 供 了 基于 Windows、Mac 和 Linux 操作 系统 的 集成 开发 环境 ,包含 完整 高 效 的 
Android 模拟 器 和 开发 工具 、 详 尽 的 说 明文 档 和 开发 示例 。 程 序 开发 人 员 可 以 快速 掌握 
Android 应 用 程序 的 开发 方法 ,同时 也 降低 了 开发 手机 应 用 程序 的 门槛 。 

2008 年 10 H 21 日 ,谷歌 公布 了 Android 平台 的 源 代码 。Android 作为 开放 源 代码 
的 手机 平台 ,任何 人 或 机 构 都 可 以 免费 使 用 Android, 并 对 它 做 出 改进 。 开 放 源 代码 的 
Android 有 利于 创新 ,能 够 为 用 户 提供 更 好 的 体验 。 同 时 也 意味 着 任何 厂商 都 可 以 推出 
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E} Android Market 


Check cut our site for some of the more popular applications and games available in Ardrcid Market. Fer a comprehensive, up-to-date list of the thousands of tilles 
that aro availatlo, you wil naod to viow Android Market on a handset. 
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图 1.16 Android Market 


基于 Android 的 手机 , 且 不 用 支付 任何 许可 费用 。Android 的 源 代码 可 以 到 谷歌 的 官方 
网 站 下 载 , 地 址 是 http://source. android. com, WHA 1. 17 所 示 。 
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1.17 Android 源 代码 的 下 载 网 站 


2008 4E 10 H 22 日 ,第 一 款 Android 手机 T-Mobile G1(HTC Dream) 在 美国 上 
市 ,由 中 国人 台湾 的 宏达电 (HTC) 制 造 , 如 图 1. 18 所 示 。 在 硬 
件 方面 ,内 置 528MHz 的 Qualcomm MSM 7201A 处 理 器 ,有 
192MB RAM 和 256MB ROM 的 内 存 空间 ,提供 侧面 滑动 的 
全 键盘 ,支持 WIFI 功能 和 内 置 GPS 模块 ,支持 最 大 8GB 容 
量 的 microSD 存储 卡 扩 展 容量 ,支持 GSM/UMTS/GPRS/ 
EDGE/HSDPA 网 络 ,在 软件 方面 ,集成 了 众多 的 应 用 功能 ， 


包括 谷歌 的 地 图 功能 .YouTube 视频 和 全 方位 导航 定位 的 
图 1.18 T-Mobile G1 功能 。 
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2. Android 1. 1 版 


2009 年 2 H , Android 1. 1 正式 发 布 ,该 版 本 修正 了 1. 0 版 本 存在 的 缺陷 ,如 设备 休 
眠 状态 的 稳定 性 问题 .邮件 冻结 问题 .POP3 链接 失败 问题 和 IMAP 协议 的 密码 引用 问 
题 。 同 时 ,增加 了 新 的 特性 ,例如 当 搜索 地 图 或 详细 查看 时 ,允许 用 户 对 地 图 进行 评论 ; 
允许 用 户 保 存 彩信 的 附件 ;为 了 更 加 方便 地 使 用 拨号 盘 , 拨 号 盘 可 以 显示 或 隐藏 在 通话 
菜单 中 等 。 

2009 年 2 月 17 日 ,第 二 款 Android 手机 T-Mobile G2(HTC Magic) 正 式 发 售 ,仍然 
由 中 国 台湾 的 宏达电 制造 ,如 图 1. 19 所 示 。T-Mobile G2 的 硬件 配置 与 T-Mobile G1 基 
本 相同 ,不 同 之 处 主要 在 于 将 内 存 空间 从 256MB 提高 到 512MB, 并 上 略微 增加 了 电池 的 容 
量 , 用 以 提升 整 机 的 使 用 时 间 。T-Mobile G1 放弃 了 影响 手机 尺寸 的 滑动 全 键盘 设计 ,使 T- 
Mobile G2 的 体积 (113mm X 55mm X 13. 65mm) 比 T-Mobile G1 (117. 7mm X 55. 7mm X 
17. 1mm) HH TID 


3. Android 1.5 版 


2009 4Æ 4 H 15 H , Android 1. 5 正式 发 布 。 此 版 本 提升 了 性 能 表现 ,提高 了 摄像 头 
的 启动 速度 和 拍摄 速度 ,提高 了 GPS 位 置 的 获取 速度 ,使 浏览 器 的 滚动 更 为 平滑 ,并 提高 
了 获取 Gmail 中 对 话 列 表 的 速度 等 。 在 新 特性 方面 ,支持 了 软 键盘 、 中 文 显示 和 中 文 输 
入 功能 ,并 可 以 将 视屏 录制 的 内 容 直 接 上 传 到 YouTube 上 。 

2009 年 6 月 24 日 ,中 国 台 湾 的 宏达电 发 布 了 第 三 款 Android 手机 HTC Hero. 在 
硬件 方面 ,使 用 Qualcomm MSM 7200A 处 理 器 ,500 万 像素 摄像 头 ,提供 3. 5mm 的 耳机 
插 孔 。 在 软件 方面 ,首次 支持 Adobe Flash 和 多 点 触 控 技术 ,最 突出 的 改进 是 使 用 了 
HTC Sense 界面 ,使 HTC Hero 的 界面 异常 美观 .绚丽 ,如 图 1.20 所 示 。 


图 1.19 T-Mobile G2 1.20 HTC Hero 


4. Android 2. 0 版 


2009 年 10 H 28 H , Android 2. 0(Eclair) 发 布 。 此 版 本 引入 了 大 量 的 新 特性 ,如 数 
字 变焦 多 点 触摸 和 多 个 账户 邮箱 等 ,并 在 账户 同步 和 蓝牙 通信 等 方面 增加 了 新 的 API, 
开发 者 使 用 这 些 新 API 实现 手机 与 各 种 联系 源 同步 ,点 对 点 连接 和 游戏 功能 。 新 版 
SDK 改进 了 图 形 架构 性 能 ,可 以 更 好 地 利用 硬件 加 速 , 改 进 了 虚拟 键盘 ,使 操作 更 为 
便利 。 
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2010 年 1 月 6 日 ,谷歌 公司 初次 发 布 了 自主 品牌 的 Android 手机 Google Nexus 
One, 如 图 1. 21 所 示 。 使 用 SnapDragon 1GHz 处 理 器 ,3.7 英寸 AMOLED 电容 屏 , 由 中 
国 台 湾 的 宏达电 代 工 生产 。Nexus One 搭载 纯净 的 Android 
2.1, 由 于 谷歌 出 品 的 手机 系统 上 没有 额外 的 限制 和 多 余 的 功 
能 ,使 这 款 手 机 在 较 长 的 时 间 内 都 是 Android 软件 理想 的 开 
发 和 测试 平台 。 


5. Android 2. 2 版 


2010 4Æ 5 H 21 日 ,Android 2. 2 版 (Froyo) 发 布 。 此 版 本 图 1.21 Google Nexus One 
在 企业 集成 .设备 管理 API\ 性 能 、 网 络 共享 .浏览 器 和 市 场 等 
方面 都 提供 了 很 多 新 特性 。 借 助 于 新 的 Dalvik JIT 编译 器 ,CPU 密集 型 应 用 的 速度 要 比 
Android 2. 1 ft 2—5 倍 , 并 加 入 对 Adobe Flash 视频 和 图 片 的 完美 支持 。 在 网 络 共享 方 


Chrome V8 引擎 ,JavaScript 代码 的 处 理 速度 要 比 Android 2. 1 H 2~3 倍 。Android 2. 2 
的 最 大 改进 是 可 以 将 应 用 程序 安装 在 microSD 卡 上 ,应 用 程序 可 以 在 内 部 存储 器 和 外 部 
存储 器 上 迁移 。 

6. Android 2. 3 版 


2010 Æ 12 H 7 H . Android 2.3(Gingerbread) 正 式 发 布 。 此 版 本 主要 增强 了 对 游戏 
的 支持 、 多 媒体 影音 和 通信 功能 。 在 游戏 方面 .增加 了 新 的 垃圾 回收 和 优化 处 理事 件 ,以 
提高 对 游戏 的 支持 能 力 , 原 生 代码 可 以 直接 访问 感应 器 事件 和 OpenSL ES ,并 增加 了 新 
的 管理 窗口 和 生命 周期 的 框架 。 在 多 媒体 影音 方面 ,支持 VP8 和 WebM 视频 格式 ,提供 
AAC 和 AMR 宽频 编码 ,提供 了 新 的 音频 效果 器 ,如 混 响 、 均 
衡 、 虚 拟 耳 机 和 低频 提升 。 在 通信 方面 ,支持 前 置 摄像 头 、 
SIP/VoIP 和 NFC( 近 场 通讯 ) 功 能 。 

2010 年 12 月 7 日 ,谷歌 公司 发 布 了 第 二 款 自主 品牌 的 
Android 手机 Google Nexus S, 如 图 1. 22 所 示 。Nexus S 使 
用 Cortex A8 处 理 器 ,默认 频率 为 1GHz,512MB 的 RAM 和 

1.22 Google NexusS 16GB 的 内 置 闪 存 , 但 不 支持 存储 卡 扩 展 ,4.0 英寸 WVGA 

(480X800) 分 辩 率 电容 触摸 屏幕 。Nexus S 支持 AGPS, X 

持 Bluetooth 2. 1 十 EDR ,支持 Wi-Fi 802. 11 n/b/g. X $$ NFC 技术 ,支持 三 轴 陀 螺 仪 .加 

速 计数 字 罗 盘 、 光 线 感应 器 和 距离 感应 器 。Nexus S 搭载 最 新 的 Android 2. 3 ,是 第 一 款 
具备 NFC 功能 的 Android 手机 。 


7. Android 3.0 版 


2011 年 2 月 3 日 ,Android 3.0 版 本 (Honeycomb) 正 式 发 布 。 这 是 专 为 平板 电脑 设 
计 的 Android 系统 ,因此 在 界面 上 更 加 注重 用 户 体验 和 和 良好 互动 性 ,重新 定义 了 多 任务 


2s Arcrcid 简 介 


11 


处 理 功能 ,丰富 的 提醒 栏 ,支持 widgets, 并 允许 用 户 自 定义 主 界面 。Android 3. 0 原生 支 
持 文件 /图 片 传输 协议 ,允许 用 户 通过 USB 接口 连接 外 部 设备 同步 数据 ,或 通过 USB 或 
蓝牙 连接 实体 键盘 进行 更 快速 的 文字 输入 ,改进 了 WiFi 
连接 ,搜索 信号 速度 更 快 ,并 可 通过 蓝牙 来 进行 tether 
连接 ,分 享 3G 信号 给 其 他 设备 。 
2011 年 1 月 6 日 ,摩托 罗拉 发 布 了 第 一 款 Android 
3.0 的 平板 电脑 Motorola Xoom, 如 图 1.23 所 示 。 硬 件 
上 采用 双核 1GHz NVIDIA Tegra 2 处 理 器 ,10. 1 F 
1.23 Motorola Xoom 1280 x 800 分 辨 率 的 触摸 屏 , 内 置 有 32GB 存储 ,并 配 有 
前 置 与 后 置 摄像 头 , 支 持 高 清 视频 录制 和 播放 功能 。 
Motorola Xoom 是 真正 意义 上 的 Android 平板 电脑 ,也 是 Android 系统 的 一 个 里 程 碑 。 


8. Android 3. 1 版 


2011 年 5 月 10 H, Android 3.1 版 本 正式 发 布 。 作 为 Android 3. 0 的 升级 版 ， 
Android 3. 1 主要 在 界面 上 做 了 一 些 美化 与 调整 ,从 桌面 到 程序 集 菜 单 的 动画 更 为 顺畅 ， 
界面 上 的 文字 颜色 与 位 置 也 稍微 作 了 调整 ,还 加 入 了 全 系统 适用 的 声音 回馈 。 增 加 了 对 
USB 设备 的 支持 ,如 支持 USB 鼠标、 键盘 和 游戏 控制 
器 等 。Widget 允许 用 户 通过 拖 电 修 改 外 观 尺 寸 ,将 
Widget 放大 后 则 可 显示 更 为 详细 的 信息 。Android 
3.1 除了 支持 许多 新 标准 与 功能 外 ,内 建 的 应 用 程序 
也 做 了 一 些 更 新 ,更 适合 平板 电脑 使 用 。 


9. Android 4. 0 版 


2011 年 10 月 19 H. Android 4. 0 版 本 (Ice Browser 
Cream Sandwich) 正 式 发 布 ,如 图 1. 24 所 示 。 这 一 版 
本 最 显著 的 特征 是 同时 支持 智能 手机 、 平 板 电脑 、. 电 
视 等 设备 , 而 不 需要 根据 设备 不 同 选择 不 同 版 本 的 
Android 系统 。 该 版 本 取消 了 底部 物理 按键 的 设计 ， 
直接 使 用 虚拟 按键 ,在 增 大 屏幕 面积 的 同时 控制 了 手 
机 整体 的 大 小 ,而 且 这 样 的 操作 方式 可 以 使 智能 手机 
与 平板 电脑 保持 一 致 。 人 脸 识别 功能 在 4. 0 版 本 中 
得 到 应 用 ,用 户 可 以 使 用 自拍 相片 设置 屏幕 锁 ， 
Android 系统 根据 脸 部 识别 结果 控制 手机 的 解锁 功 Sot AU NUR 
能 。 另 一 个 有 趣 的 应 用 是 基于 NFC 的 Android Beam 
功能 ,可 以 让 两 部 手机 在 接近 到 4cm 后 交换 信息 ,可 交换 的 内 容 包 括 网 站 、 联 系 人 .导航 、 
YouTube 视频 等 ,甚至 是 电子 市 场 的 下 载 链接 也 是 可 以 交换 的 。 


Market 
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Android 广泛 支持 GSM、3G 和 4G 的 语音 与 数据 业务 ,支持 接收 语言 呼叫 和 SMS 短 
信 ,支持 数据 存储 共享 和 IPC 消息 机 制 ,为 地 理 位 置 服务 .谷歌 地 图 服务 提供 易于 使 用 的 
API 函数 库 ,提供 组 件 复 用 和 内 置 程序 蔡 换 的 应 用 程序 框架 ,提供 基于 WebKit 的 浏览 
器 ,广泛 支持 各 种 流行 的 视频 .音频 和 图 像 文 件 格式 ,支持 的 格式 有 MPEG4, H264, 
MP3、AAC、AMR、JPG、PNG 和 GIF ,为 2D 和 3D 图 像 处 理 提供 专用 的 API 库 函数 。 

Android 系统 提供 了 访问 硬件 的 API 库 函 数 ,用 来 简化 像 摄 像 头 .GPS 等 硬件 的 访 
问 过 程 。 只 要 支持 Android 应 用 程序 框架 的 手机 ,对 硬件 访问 的 方法 是 完全 一 致 的 , 因 
此 即使 将 应 用 程序 移植 到 不 同 硬件 配置 的 手机 上 ,也 无 须 改变 应 用 程序 对 硬件 的 访问 方 
ik. Android 支持 的 硬件 包括 GPS、 摄 像 头 、 网 络 连接 、Wi-Fi、 蓝 牙 .NFC、 加 速度 计 、 触 摸 
屏 和 电源 管理 等 。 

在 内 存 和 进程 管理 方面 ,Android 具有 自己 的 运行 时 和 虚拟 机 。 与 Java 和 . NET 运 
行 时 不 同 ,Android 运行 时 还 可 以 管理 进程 的 生命 周期 。Android 为 了 保证 高 优先 级 进 
程 运 行 和 正在 与 用 户 交 互 进程 的 响应 速度 ,允许 停止 或 终止 正在 运行 的 低 优先 级 进程 ， 
以 释放 被 占用 的 系统 资源 。Android 进程 的 优先 级 并 不 是 固定 不 变 的 ,而 是 根据 进程 是 
和 否 在 前 台 或 是 否 与 用 户 交互 而 不 断 变化 的 。Android 生命 周期 和 调试 的 相关 内 容 在 第 4 
章 进 行 介绍 。 

在 界面 设计 上 ,Android 提供 了 丰富 的 界面 控件 供 开 发 者 调用 ,从 而 加 快 了 用 户 界 面 
的 开发 速度 ,也 保证 了 Android 平台 上 程序 界面 的 一 致 性 。Android 将 界面 设计 与 程序 
32 SEA) BS ,使 用 XML 文件 对 界面 布局 进行 描述 ,有 利于 界面 的 修改 和 维护 。 用 户 界面 的 
相关 内 容 在 第 5 章 进行 介绍 。 

Android 提供 轻 量 级 的 进程 通信 机 制 Intent, 使 跨 进 程 组 件 通 信和 和 发送 系 统 级 广播 
成 为 可 能 。 通 过 设置 组 件 的 Intent 过 滤器 ,组 件 利 用 匹配 和 筛选 机 制 ,可 以 准确 地 获取 
和 处 理 Intent。 组 件 通信 与 广播 消息 的 相关 内 容 在 第 6 章 进行 介绍 。 

Android 提供 了 Service 作为 无 用 户 界面 .长 时 间 后 台 运 行 的 组 件 。Android 是 多 任 
务 系统 ,但 受到 屏幕 尺寸 的 限制 ,同一 时 刻 只 允许 一 个 应 用 程序 在 前 台 运行 。Service 无 
需 用 户 干 预 ,可 以 长 时 间 、 稳 定 地 后 台 运 行 , 可 为 应 用 程序 提供 特定 的 后 台 功 能 ,还 可 以 
实现 事件 处 理 或 数据 更 新 等 功能 。 后 台 服务 相关 内 容 在 第 7 章 进行 介绍 。 

Android 支持 高 效 ,快速 的 数据 存储 方式 ,包括 SharedPreferences、 文 件 存 储 和 轻 量 
级 关系 数据 库 SQLite, 应 用 程序 可 以 使 用 适合 的 方法 对 数据 进行 保存 和 访问 。 同 时 ,为 
了 便于 跨 进程 共享 数据 , Android 提供 了 通用 的 共享 数据 接口 ContentProvider, 可 以 在 
无 须 了 解数 据 源 .路 径 的 情况 下 ,对 共享 数据 进行 查询 、 添 加、 删除 和 更 新 等 操作 。 数 据 
存储 与 访问 相关 内 容 在 第 8 章 进行 介绍 。 

Android 支持 位 置 服务 和 地 图 应 用 ,可 以 通过 SDK 提供 的 API 直接 获取 当前 的 位 
置信 息 ,追踪 设备 的 移动 路 线 ,或 设 定 敏感 区 域 , 并 可 以 将 Google 地 图 做 入 到 Android 
应 用 程序 中 ,实现 地 理 信息 的 可 视 化 开发 。 位 置 服务 和 地 图 应 用 的 相关 内 容 将 在 第 9 章 
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进行 介绍 。 

Android 支持 Widget 插件 ,可 以 方便 地 在 Android 系统 上 开发 桌面 应 用 ,实现 常见 
的 桌面 小 工具 ,或 在 主屏 上 显示 重要 的 信息 。 随 着 Android 系统 可 以 在 平板 电脑 上 使 
Hi. Widget 插件 的 实用 性 也 在 不 断 的 提高 。Android Widget 的 相关 内 容 将 在 第 10 章 进 
行 介绍 。 

Android NDK 支持 使 用 本 地 代码 (C 或 C++ ) 开 发 应 用 程序 的 部 分 核心 模块 ,提高 
了 程序 的 运行 效率 ,并 有 助 于 增加 Android 开发 的 灵活 性 。Android NDK 的 相关 内 容 将 
在 第 11 章 进行 介绍 。 


14 Andod 体 系 结 构 


Android 是 基于 Linux 内 核 的 软件 平台 和 操作 系统 ,采用 了 软件 堆栈 (Software 
Stack) 的 架构 , 共 分 为 4 层 , 如 图 1.25 所 示 。 第 一 层 是 Linux 内 核 ,提供 由 操作 系统 内 核 
管理 的 底层 基础 功能 ;第 二 层 是 中 间 件 层 , 由 函数 库 和 Android 运行 时 构成 ;第 三 层 是 应 
用 程序 框架 层 , 提 供 了 Android 平台 基本 的 管理 功能 和 组 件 重用 机 制 ;第 四 层 是 应 用 程 
序 层 ,提供 了 一 系列 核心 应 用 程序 。 


应 用 程序 
3 iR iE 
邮件 客户 端 通讯 录 日 历 浏览 器 EE 第 四 层 应 用 程序 层 
应 用 程序 框架 
Activity Window Content View 
Manager Manager Providers System 第 三 层 应 用 程序 框架 层 
Package Telephony Resource Location Notification 
Manager Manager Manager Manager Manager 
函数 库 Android 运 行 时 
Surface Media A 核心 库 
Manager Framework SQLite —— i 
Dalvik 虚 拟 机 第 二 层 中 间 件 层 
OpenGLES || FreeType || weski I 
SGL sst || te 
Linux 内 核 
安全 机 制 | Laree] | 进程 管理 | [mamu Si - Bland 
电源 管理 | [ WiFi 驱动 显示 驱动 


图 1.25 Android 体系 结构 


Android 平台 的 底层 使 用 的 是 Linux 3. 0 内 核 , 是 硬件 和 其 他 软件 堆栈 之 间 的 一 个 
抽象 隔离 层 。 提 供 安 全 机 制 、 内 存 管 理 . 进 程 管理 .网 络 协议 堆栈 .电源 管理 和 驱动 程序 
等 功能 ,驱动 程序 包括 Wi-Fi 驱动 ,声音 驱动 .显示 驱动 .摄像头 驱动 .闪存 驱动 .Binder 
(IPC) 驱 动 和 键盘 驱动 等 。 
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函数 库 在 Linux 内 核 之 上 ,提供 了 一 组 基于 C/C++ 的 函数 库 , 程 序 开发 人 员 可 以 通 
过 应 用 程序 框架 调用 这 些 函 数 库 。 主 要 的 函数 库 包 括 : Surface Manager, 支 持 显示 子 系 
统 的 访问 ,为 多 个 应 用 程序 提供 2D、3D 图 像 层 的 平滑 连接 ; Media Framework, 基于 
OpenCORE 的 多 媒体 框架 ,实现 音频 ,视频 的 播放 和 录制 功能 ,广泛 支持 多 种 流行 的 音 视 
频 格式 ,包括 MPEG4、H. 264, MP3, AAC, AMR JPG 和 PNG 等 ;SQLite, 轻 量 级 的 关系 
数据 库 引 擎 ;OpenGL ES, 基 于 硬件 的 3D 图 像 加 速 ; FreeType, 位 图 与 矢量 字体 泻 染 ; 
WebKit, Web 浏览 器 引擎 ;SGL,2D 图 像 引擎 ;SSL ,数据 加 密 与 安全 传输 的 函数 库 ;libc， 
标准 C 运行 库 , 是 Linux 系统 中 底层 的 应 用 程序 开发 接口 。 

Android 运行 时 由 核心 库 和 Dalvik 虚拟 机 构成 。 核 心 库 为 程序 开发 人 员 提 供 了 
Android 系统 的 特有 函数 功能 和 Java 语言 的 基本 孔 数 功能 。Dalvik 虚拟 机 是 经 过 优化 
的 多 实例 虚拟 机 ,基于 寄存 器 架构 设计 ,实现 了 基于 Linux 内 核 的 线程 管理 和 底层 内 存 
管理 。Dalvik 虚拟 机 采用 专用 的 Dalvik 可 执行 格式 (. dex) ,该 格式 适合 内 存 和 处 理 器 速 
度 受 限 的 系统 。 

应 用 程序 框架 提供 了 Android 平台 基本 的 管理 功能 和 组 件 重用 机 制 ,包括 Activity 
管理 . 窗 体 管 理 , 包 管理 .电话 管理 资源 管理 ,位置 管 理 .通知 消息 管理 .View 系统 和 内 
容 提供 者 等 。ContentProvider 用 来 共享 私有 数据 ,实现 跨 进程 的 数据 访问 ; Resource 
Manager 允许 应 用 程序 使 用 非 代码 资源 ,如 图 像 、 布 局 和 本 地 化 的 字符 串 等 ;Notification 
Manager 允许 应 用 程序 在 状态 栏 中 显示 提示 信息 ; Activity Manager 用 来 管理 应 用 程序 
的 生命 周期 ;Window Manager 用 来 启动 应 用 程序 的 窗 体 ;Location Manager 用 来 管理 与 
地 图 相关 的 服务 功能 ; Telephony Manager 用 来 管理 与 电话 相关 的 功能 ; Package 
Manager 用 来 管理 安装 在 Android 系统 内 的 应 用 程序 。 

应 用 程序 层 提 供 了 一 系列 核心 应 用 程序 ,包括 电子 邮件 客户 端 .浏览 器 .通讯 录 、 日 
历 、 相 册 、 地 图 和 电子 市 场 等 。 


E E 
l. 简 述 各 种 手机 操作 系统 的 特点 。 


2. 简 述 Android 平台 的 特征 。 
3. 描述 Android 平台 体系 结构 的 层次 划分 ,并 说 明 各 个 层次 的 作用 。 


Android 开发 环境 


Android 开发 环境 的 安装 与 配置 是 开发 Android 应 用 程序 的 第 一 步 ,也 是 深入 理解 
Android 系统 的 一 个 良好 的 途径 。 通 过 本 章 的 学 习 , 读 者 可 以 掌握 安装 、 配 置 Android 开 
发 环境 的 步骤 和 注意 事项 ,理解 Android SDK 和 ADT 插件 的 用 途 ,熟悉 在 应 用 程序 开 
发 过 程 中 可 能 会 使 用 到 的 开发 工具 。 

本 章 学 习 目 标 : 

。 掌握 Android 开发 环境 的 安装 配置 方法 ; 

* 了 解 Android SDK 的 目录 结构 和 示例 程序 ; 

。 掌握 各 种 Android 开发 工具 的 用 途 。 
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Eclipse 是 开发 Android 应 用 程序 的 首选 集成 开发 环境 。Eclipse 作为 开源 的 Java 开 
发 环境 ,功能 强大 ,易于 使 用 。Android 提供 了 在 Eclipse 上 开发 Android 应 用 程序 的 
ADT fifif Android Development Toolkit. ADT) ,简化 了 Android 应 用 程序 的 开发 、 运 
行 和 调试 。 

安装 Android 开发 环境 ,首先 需要 安装 支持 Java 程序 运行 的 Java 开发 工具 包 (Java 
Development Kit. JDK) ,然后 安装 集成 开发 环境 Eclipse, 最 后 安装 Android SDK 和 
Eclipse 的 ADT 插件 。 


211 安装 JDK Eclipse 


在 开始 下 载 和 安装 Eclipse 之 前 ,应 首先 确认 开发 主机 上 已 经 安装 了 Java 运行 环境 
(Java Runtime Environment,JRE)。 因 为 Eclipse 是 用 Java 语言 编写 的 应 用 程序 ,需要 
JRE 才能 运行 。 如 果 JRE 没有 安装 或 者 没有 被 检测 到 ,尝试 打开 Eclipse 时 会 有 错误 提 
示 , 如 图 2.1 所 示 。 

安装 JRE 的 系统 可 以 运行 Java 应 用 程序 ,但 如 果 需 要 进行 Java 应 用 程序 的 开发 ,应 
该 直接 安装 JDK。 因 为 JDK 中 包含 完整 的 JRE, 所 以 只 要 安装 JDK 后 ,JRE 也 自动 安装 
在 操作 系统 中 。 


A (第 2 版 ) 


A Java Runtime Environment (JRE) or Java Development Kit (DK) 
must be available in order to run dips Exerc peas 
was found after searching the following locations: 

E: drei dlackipsatjralbtnl ores. exe 


javew exe in your current PATH 


图 2.1 RARR JRE 的 错误 提示 


1. JDK 的 下 载 与 安装 


JDK 的 基本 组 件 包 括 : 编译 器 ,将 源 程 序 转 成 字 节 码 ; 打 包工 具 , 将 相关 的 类 文 
件 打包 成 一 个 文件 ;文档 生成 器 ,从 源码 注释 中 提取 文档 ; 查 错 工具 ,用 来 进行 调试 
和 查 错 。 

JDK 可 以 到 Oracle 的 官方 网 站 下 载 ,在 浏览 器 中 输入 下 面 的 网 址 http://www. 
oracle. com/technetwork/java/javase/downloads/index. html. 显示 的 页 面 如 图 2. 2 所 
示 , 然 后 单 击 Java SE 7 中 的 JDK Download 按钮 ,进入 JDK 的 下 载 页 面 。 


Java Platform, Standard Edition 


Java SET JDK JRE 

This release includes new features such as small 
language changes for improved developer - ni 

productivity, a new Filesystem API, support for 


asynchronous I/O, a new fork/join framework for JDK 7 Docs JRE 7 Docs 
multicore performance, improved support for » 2 

dynamic and script languages, updates to security, ood € : 
internationalization and web standards and much a na 
more. * ReadMe * ReadMe 
Lear more » Pe E 


* ReleaseNotes * ReleaseNotes 


"What Java Do I Need?" You must have a copy of |, . 
the JRE (Java Runtime Environment) on your Orade License Oracle License 


system to run Java applications and applets. To * Java SE * Java SE 
develop Java applications and applets, you need Products Products 
the JDK (Java Development Kit), which includes the 
JRE. * Third Party * Third Party 
Licenses Licenses 
* Supported * Supported 
System System 


Configurations Configurations 


图 2.2 JavaSE 选择 页 面 


在 JDK 的 下 载 页 面 中 ,首先 需要 同意 Oracle 的 Java SE 二 进 制 代 码 协 议 , 选 择 
Accept License Agreement, 然 后 根据 用 户 的 系统 选择 不 同 版 本 的 JDK。 如 果 是 32 位 的 
Windows 系统 ,选择 下 载 Windows x86; 如 果 是 64 位 的 Windows 系统 ,选择 下 载 
Windows x64, 如 图 2.3 所 示 。 

笔者 使 用 的 是 64 位 的 Windows 7 系统 ,因此 选择 下 载 Windows x64, 文 件 的 名 称 为 
jdk-7-windows-x64. exe。 

在 JDK 的 安装 过 程 中 ,一 般 情况 下 保持 JDK 的 默认 设置 即 可 ,JDK 会 安装 在 
C:\Program File\Java\jdk1. 7.0\ 目 录 下 ,如 图 2.4 所 示 。 

在 JDK 安装 完毕 后 ,安装 程序 提示 “Java(TM) SE Development Kit 7(64-bit) 已 成 


Os Arcrcid 开 发 环境 


17 


Java SE Development Kit 7 


You must accept the Oracle Binary Code License Agreement for Java SE to download this 
software. 


<- Accept License Agreement © Decline License Agreement 


Product / File Description File Size Download 

Linux x86 - RPM Installer 77.28 MB $ jdk-7-linux-i586 rpm 
Linux x86 - Compressed Binary 92.17 MB Ž jdk-7-linux-i586 tar.gz 
Linux x64 - RPM Installer 77.91 MB 3 jdk-7-linux-x64 rpm 

Linux x64 - Compressed Binary 90.57 MB Š jdic7-linux-x64 tar gz 
Solaris x86 - Compressed Packages 15474 MB jdk-7-solaris-i586 tar Z. 
Solaris x86 - Compressed Binary 9475MB Š jdk-7-solaris-i586 tar gz 
Solaris SPARC - Compressed Packages 157.81 MB $ jdi-T-solaris-sparc tar Z 
Solaris SPARC - Compressed Binary 99.48 MB  jdk-7-solaris-sparc tar gz 
Solaris SPARC 64-bit - Compressed Packages 16.28 MB Š jdi-7-solaris-sparcv9 tar.Z 
Solaris SPARC 64-bit - Compressed Binary 1238MB 5 jdk-7-solaris-sparcv9 tar gz 
Solaris x64 - Compressed Packages 1466 MB $ jdi-7-solaris-x64 tar Z 
Solaris x64 - Compressed Binary 9.39 MB # jdk-7-solaris-x64 tar.gz 
Windows x86 7948 MB 5 jdk-7-windows-i586.exe. 
Windows x64 80.25 MB * jdk-7-windows-x64 exe 


图 2.3 JDK 下 载 页 面 


基 Java(TM) SE Development Kit 7 (64-bit) - 自 定义 安装 


Mn ri an Eee 安装 完成 后 ， 您 可 以 使 用 控制 面板 "中 的 "添加 / 


DURER 
ED Ez Java(TM) SE Development Kit 7 
X -| 演示 程序 及 样 人 二 
源 代码 E d 


安装 到 : 
C:\Program Files Javalidk1.7,0V 


2.4 JDK 的 默认 设置 


功 安装 ”, 如 图 2.5 所 示 。 下 一 步 可 以 进行 Eclipse 的 安装 工作 了 。 
2. Eclipse 的 下 载 与 安装 


要 下 载 Eclipse 可 以 在 浏览 器 输入 http://www. eclipse. org/downloads, 进入 
Eclipse 的 下 载 页 面 ,在 Eclipse IDE for Java Developers, 122MB 项 目 中 ,根据 自身 操作 
系统 的 版 本 选择 下 载 32 位 或 64 位 版 本 的 Eclipse, 如 图 2.6 所 示 。 

FRH Eclipse 是 一 个 ZIP 文件 ,文件 名 为 eclipse-java-indigo-win32-x86_64. zip, 直 
接 将 ZIP 文件 中 的 eclipse 文件 夹 解压 缩 到 指定 的 目录 中 即 可 。 双 击 目录 中 的 eclipse 
. exe 文件 ,出 现 Eclipse 集成 开发 环境 的 启动 画面 ,如 图 2.7 所 示 。 如 果 没 有 出 现 启动 画 
面 ,可 以 尝试 重新 启动 计算 机 。 
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Compare Packages Older Versions 


e 


è Eclipse Classic 3.7, 174MB 


Downloaded 695,578 Times Details 


期 Java(TM) SE Development Kit 7 (64-bit) -完成 z 


& 


ava 


ORACLE 


Java(TM) SE Development Kit 7 (64-bit) 已 成 功 安装 


产品 注册 是 免费 的 ， 您 将 获得 如 下 增值 服务 : 

本 、 修 补 程序 和 更 新 的 通知 服务 
:É 有 有 友 者 产品 RAVINE 
M 


关 Orade JF 

过 期 版 本 和 文档 的 访问 权限 

当 您 单 击 -完成 "后 将 收集 产品 与 系统 信息 ， 同 时 显示 OK 产品 注册 表单 。 如 果 您 
注册 ， 则 不 保存 以 上 信息 - 


有 关注 册 所 收集 的 数据 以 及 这 些 数 据 的 管理 和 使 用 方式 的 更 多 信息 ， 请 参见 产品 
注册 信息 外面。 


Eclipse IDE for Java EE Developers. 212 MB 
Downloaded 894,585 Times ^ Details 


2.5 JDK 安装 成 功 界面 


idows (el 


J Windows 32 Bit 


SE Windows 64 Bit 


Other Downloads 


* Eclipse IDE for Java Developers. 122 MB Jii, Windows 32 Bit 
"a Downloaded 250,202 Times Details. = Windows 64 Bit. 


图 2.6 Eclipse 下 载 页 面 


2.7 Eclipse 启动 画面 


Jg, Windows 32 Bit 
X Windows 64 Bit 


Eclipse 启动 时 会 提示 用 户 选择 默认 工作 目录 ,以 后 创建 的 工程 将 保存 在 这 个 工作 目 
录 中 。 默 认 工 作 目录 的 路 径 是 系统 的 用 户 目录 ,建议 用 户 选择 其 他 位 置 作 为 eclipse 的 工 
作 目 录 。 笔 者 选择 的 工作 目录 是 G:\Android\workplace, 如 图 2. 8 所 示 。 建 议 选 择 复 选 


框 Use this as the default and do not ask again ,将 选择 的 工作 目录 作为 默认 工作 目录 ,不 
必 每 次 启动 时 都 重新 选择 工作 目录 。 
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4B. Workspace Launcher. 
Select a workspace 


Eclipse stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 


Workspace: GAAndroidWworkplace. 


ise this as the default and do not ask agair 


图 2.8 Eclipse 工作 目录 设 定 
正常 启动 后 的 Eclipse 集成 开发 环境 如 图 2.9 所 示 。 


n-m-EGRib-O-Q-iwg-imof- H-L-vo-s- Tj # betua Doms [Bs] 
(8 package Explorer 23 EH ROCES RR E 
Basie” C 
ouine f not availabe. 
E Problems [@ Javadoc [© Dedaration [ 回 Corsole i 7.39 Debug [M Properties ma-mn-c 
[No consoles to display at Is me. 


图 2.9 Eclipse 集成 开发 环境 


到 此 为 止 ,Eclipse 和 JDK 已 经 安装 完毕 ,但 在 创建 Android 工程 之 前 ,还 需要 安装 
Android SDK 和 ADT 的 插件 ,并 完成 Eclipse 的 相关 设置 。 


212 安装 Andrad SDK 
Android SDK 是 Android 软件 开发 工具 包 (Android Software Development Kit) ,是 
Google 公司 为 了 提高 Android 应 用 程序 开发 效率 、 减 少 开 发 周期 而 提供 的 辅助 开发 工 
有 具 、 开 发 文档 和 程序 范例 。 
从 Google 的 Android 项 目 主页 http://code. google. com/intl/zh-CN/android/ ,不 
仅 可 以 找到 Android SDK 的 下 载 地 址 ,还 可 以 获得 像 Google 编程 大 赛 .最 新 的 API 插件 
的 信息 ,如 图 2. 10 所 示 。 


除 此 以 外 , Android 项 目 主页 还 提供 了 两 个 重要 的 参考 网 站 : (1) www. android 
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CA 2 版 ) 


.com, 这 里 可 以 获取 到 Android 的 一 般 性 介绍 ,以 及 各 个 版 本 Android. 系统 的 图 片 和 图 
标 ;(2)developer. android. com, 这 里 有 大 量 关 于 Android 的 开发 信息 ,包括 SDK 开发 文 


面向 Android 的 Google 项 目 


Android 是 用 于 移动 设备 的 软件 堆栈 ,包括 操 作 系统 、 中 间 件 和 关键 应 用 程序 。Android SDK 提供 了 必需 的 工具 和 API, 用 于 开始 开 
发 在 Android 驱动 的 设备 上 运行 的 应 用 程序 , 


此 网 站 提供 了 有 关 基 于 Android 平台 的 Google 项 目的 信息 ， 例 加 扩 展 Android TORUM. Android 应 用 程序 、 托 管 的 服务 和 
API、Android 开发 人 员 竞赛 等 等 。 此 网 站 的 所 有 内 容 均 由 Google 为 了 Android 开发 人 员 的 利益 而 提供 。 


如 果 您 要 查找 关于 Android 的 一 般 信息 ， 请 访问 www android com 网 站 。 如 果 您 对 开发 用 于 Android 设备 的 应 用 程序 感 兴 趣 , 
ÎE] Android 开发 人 员 网 站 ,网址 是 developer android. com 


Google API 插 件 


Google API 播 件 扩展 您 的 Android SDK ,使 您 的 应 用 程序 能 够 访问 Google Fr ( 例如 地 图 ) 。 利 用 地 
图 库 ， 息 可 以 将 强大 且 地 矢 功 能 快速 认 加 到 您 的 Android 应 用 程序 中 。 


THE» 


Æ 2.10 Google 的 Android 项 目 主页 


档 、 参 考 索 引 和 示例 代码 等 。 


Android SDK 的 下 载 地 址 是 http: //developer. android. com/sdk/index. html, 在 页 
面 中 可 以 选择 下 载 不 同 操作 系统 版 本 的 Android SDK, Windows 系统 提供 可 执行 文件 
版 本 (installer_rl4-windows. exe) fl ZIP 文件 版 本 (android-sdk_rl4-windows. zip) ,笔者 


选择 下 载 ZIP 文件 版 本 。 


_rl4-windows. exe 或 android-sdk_rl4-windows. zip 上 


在 如 图 2. 11 的 左 侧 列 出 不 同 版 本 的 Android SDK, 需 要 注意 的 是 左 侧 并 不 是 用 来 
选择 下 载 不 同 版 本 的 SDK ,而 仅仅 是 对 不 同 版 本 SDK 的 简介 。 读 者 要 下 载 的 installer 
只 是 SDK 的 安装 工具 ,真正 的 SDK 


版 本 选择 和 内 容 下 载 将 在 后 面 的 步骤 中 进行 


developers seri repere Tin 
Home DevGuide ^ Reference Resources ^ — Videos Blog 

Android SDK Starter Package. 

7 Download the Android SDK 

Installing ihe SDK 
Downloadable SOK Componente Welcome Developers! If you are new to the Android SDK, please read the steps below, for an overview of how 
ding SDK Components lo setup the SDK. 
die perci H youre aeady using the Android SDK, you shouid update to the latest fols or plattor using tho Andro 
P Android 3.1 Piatiom SDK and AVD Manager, rather than downloading a new SDK starter package. See Adding SDK Components. 


48d44aedcfcadede6862: 
» Android 2.1 Platform. Windows. androksdk ri4-windowszip 33840273 1acb53caee80 
» Other Patoms bylos 
SDK Tools, r14 "ew 
P st installer r14-vwandows exo. 1328c2c962908b3’ 
Google USB Driver, r4 33853301 —— 4f1cb329a41 /taotltb. 
Support Package, rà t rn bytes 
rp MacOSX androwsdk ri4macosxzp 30428734 #812687018435382de8486r3bb26a5db4 
ADT 1400 t nten bytes 
Native Development Tools 
us Mam Limux(386)  androd.sdk ri4muxigr 26075998 — 35c989W67184766dc4960813edo8ab5 


图 2.11 Android 开发 站 点 主页 面 


笔者 选择 下 载 android-sdk_rl4-windows. zip 文件 ,将 ZIP 文件 解压 到 硬盘 的 任意 目 
录 中 ,笔者 将 Android SDK 解压 到 G:NAndroidVandroid-sdk-windows 目录 中 。 然 后 运 
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行 目录 中 的 “SDK 管理 器 "(SDK Manager. exe) ,下 载 最 新 的 版 本 Android SDK. 

SDK 管理 器 运行 后 自动 获取 可 下 载 的 SDK 列表 和 辅助 工具 列表 ,耐心 等 待 后 将 显 
示 所 有 可 下 载 的 内 容 , 如 图 2. 12 所 示 , 建 议 下 载 最 新 版 本 的 Android 4. 0 和 辅助 工具 
(Extras) 中 的 全 部 内 容 。 安 装 过 程 非常 漫长 ,在 安装 成 功 后 ,所 有 安装 包 的 状态 栏 
(Status) 将 从 Not installed 更 改 为 Installed。 


WAeidsDKMamge | 

Packages Tools 
SDK Path: GAAndroid\ATocls\android-sdk-windows 
Packages 


(^ Name APL Rev Status 

4 PE Teoks] 
E X. Andrcid SDK Tools 14 $ installed 
p Android SDK Platform-tools $ Not instaled 

> È Android 40 (API 14) 

» [FG] Android 3.2 (API 13) 

> 加 多 Android 3.1 (AP 12) 

» E Android 3.0 (API 11) 

^ [E Android 2.3.3 (API 10) 

» E È Ardroid 2:2 (API 8) 

> E G Ardreid 2.1 (AP 7) 

> E G Android 16 (APLA) 

> EE Ga Andrcid 1.5 (API 3) 


show. (|Updates/New Wlinstalled [F]Obsolete Select New/Updates [kal 12 packages 


Sort by: @ API level © Repository Deselect Al Delete packages... 


Done loading packages Cue 


图 2.12 SDK 管理 器 的 建议 下 载 内 容 


在 Eclipse 中 开发 Android 程序 ,还 需要 把 Android SDK 与 Eclipse 开发 环境 关联 起 
来 ,具体 的 关联 方法 在 下 一 小 节 中 进行 介绍 。 
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ADT 插件 是 Eclipse 开发 环境 的 定制 插件 ,为 开发 Android 应 用 程序 提供 了 一 个 强 
大 ,完整 的 开发 环境 ,可 以 快速 地 建立 Android 工程 ,用户 界面 和 基于 Android API 的 组 
件 , 还 可 以 在 Eclipse 中 使 用 Android SDK 提供 的 工具 进行 程序 调试 ,或 对 apk 文件 进行 
签名 等 。 

一 般 情况 下 ,推荐 用 户 使 用 安装 ADT 插件 的 Eclipse 开发 Android 应 用 程序 ,因为 
目前 为 止 Eclipse 仍 是 较为 便捷 、 快 速 的 Android 开发 环境 。 在 Eclipse 和 Android SDK 
正确 安装 后 ,就 可 以 下 载 并 安装 ADT 插件 了 。 

有 两 种 方法 安装 ADT 插件 .一 种 方法 是 手动 下 载 ADT 插件 的 压缩 包 , 然 后 在 
Eclipse 中 进行 安装 ; 另 一 种 方法 是 在 Eclipse 中 输入 插件 的 下 载 地 址 ,由 Eclipse 自动 完 
成 下 载 和 安装 工作 。 这 两 种 方法 下 面 都 会 进行 介绍 ,推荐 使 用 第 一 种 方法 ,安装 成 功 的 
几率 很 高 ,而且 下 载 到 本 地 磁盘 的 ADT 插件 压缩 包 可 以 再 次 使 用 。 
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1. 方法 一 ,手动 下 载 ADT 插件 


手动 下 载 ADT 插件 压缩 包 的 网 址 是 http://dl-ssl. google. com/android/eclipse/。 
如 果 上 面 提 供 的 网 址 无 法 下 载 ADT 插件 ,可 以 尝试 在 从 Android 的 开发 者 网 站 中 下 载 ， 
下 载 地 址 为 http://developer. android. com/sdk/eclipse-adt. html # installing, 打 开 后 如 
图 2.13 所 示 , 单 击 ADT-14. 0. 0 即 可 完成 下 载 。 


+ Other Platforms If you aro still unable to uso Eclipso to download the ADT plugin as a remoto updato 
SDK Tools, r14 "ew site, you can download the ADT zip file to your local machine and manually install it: 


Google USB Driver, r4 1. Download the current ADT Plugin zip file from the table below (do not unpack it) 


Support Package, r4 newt 
Mm i i 
ADT ADT1400zp 6747816 3883973cd229dc4336911117af949509 
Native Development Tools " 1400 ^ 


Android NDK, r6b 
What is the NDK? 


Follow steps 1 and 2 in the default install instructions (above). 


ore Informatori In the Add Site dialog, click Archive. 


OEM USB Drivers 


2 
3 

SDK System Requirements 4. Browse and select the downloaded zip file. 
5. Enler a name for the local update site (e.g. "Android Plugin") in the "Name" field. 


SDK Archivos. 


2.13 ADT 插件 的 下 载 页 面 


下 载 到 ADT 插件 压缩 包 后 ,启动 Eclipse, 选 择 Help Install New Software, 打开 
Eclipse 的 插件 安装 界面 ,如 图 2. 14 所 示 。 


LIN a 
Available Software 
Select a site or enter the location of a site. | 
Work with SEITE -| 
Find more software by working with the “Available Software Sites" preferences. 
[ype fiter tex 
Name Version. 


E O There is no site selected. 


Details 


国 Show only the latest versions of available software E Hide items that are already installed 
RI Group items by category What is already installed? 

El Show anly snfware applicable tn target environment 

(V) Contact all update sites during install to find required software. 


o < Back Nes Es] Eee 


图 2.14 Eclipse 的 插件 安装 界面 


在 单 击 Add 按钮 后 ,将 弹出 Add Repository 界面 . 单 击 Archive 按钮 ,选择 ADT 插 
件 压 缩 包 在 本 地 磁盘 中 的 位 置 ,如 图 2. 15 所 示 。 
在 ADT 插件 安装 前 ,会 提示 用 户 对 需要 安装 的 插件 进行 选择 和 确认 ,如 图 2. 16 所 
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图 2.15 Add Repository 界面 


示 。 在 复 选 框 中 选中 Android DDMS, Android Development Tools, Android Hierarchy 
Viewer 和 Android Traceview ,然后 单 击 Next 按钮 进入 ADT 搬 件 许可 界面 。 


I] (Android DDMS 

3 Android Development Tools 
IV] 3 Android Hierarchy Viewer 
Qj Android Traceview 


Version 


14.0.0.v201110171935-205994 
14.0.0.v201110171935-205994 
14.0.0.v201110171935-205994 
14.0.0.v201110171935-205994 


图 2.16 ADT 


插件 安装 选项 


最 后 ,还 需要 认可 一 些 开源 软件 的 许可 协议 ,如 图 2. 17 所 示 , 只 要 选中 I accept the 


terms of the license agreements 单 选 项 即 可 。 


B install 
Review Licenses 
Licenses must be reviewed and accepted before the software can be installed. 
licenses: license text: 

4 Apache License. Apache License - 
Android Hierarchy Viewer 14.0.0./201110171935-205994 Version 2.0, January 2004 a 
Android Traceview 14.0.04201110171935-205994 https/ [wee apache org/ficenses] 

4 Note: jcommor-10.12jar is under the BSD license rather than the APL Yo| TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND 
Android DDMS 14.0.0./201110171935-205994. DISTRIBUTION 

4 Note: kxml2-2.3.0jar is under the BSD license rather than the EPL. You car 
Android Development Tools 14.0.0v201110171935-205994 1 Definitions. - 

© Laccept the terme cf the licence agreemente 
Cr ed + | S 1 do not accept the terms of the license agreements 
9 (utes nem. ][ mm (nemen 


2.17 ADT 插 件 许 可 界面 


整个 安装 过 程 会 持续 几 分 钟 , 安 装 结束 后 会 出 现 Eclipse 重启 提示 ,选择 Restart 
Now 按钮 重新 启动 Eclipse. {Ë ADT 插件 生效 。 


2. 方法 二 ,自动 下 载 ADT 插件 


Eclipse 自动 下 载 ADT 插件 的 方法 与 手动 方法 安装 相似 ,不 同 之 处 在 于 不 需要 到 网 
站 上 下 载 ADT 插件 压缩 包 ,而 直接 在 Add Repository 界面 中 输入 ADT 插件 的 下 载 地 


址 即 可 ,如 图 2. 18 所 示 。 
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图 2.18 自动 下 载 ADT 插件 


在 Location 文本 框 中 输入 https://dl-ssl. google. com/android/eclipse/ , 单 击 OK 按 
钮 后 ,Eclipse 会 通过 网 络 自动 搜索 可 安装 的 插件 ,并 显示 如 图 2. 16 所 示 的 ADT 插件 安 
装 选项 界面 ,之 后 的 安装 过 程 与 手动 下 载 ADT 插件 的 方法 完全 一 致 。 

无 论 采 用 哪 种 方法 安装 ADT 插件 ,在 ADT 插件 安装 完毕 后 ,进入 配置 Android JF 
发 环境 的 最 后 一 步 : 设置 Android SDK 的 保存 路 径 。 首 先 选择 Window Preferences 
打开 Eclipse 的 配置 界面 ,然后 单 击 左 侧 Android 打开 Android 配置 界面 ,在 SDK 
Location 文本 框 中 输入 Android SDK 的 保存 路 径 , 最 后 单 击 Apply 按钮 使 设置 生效 ,如 
图 2. 19 所 示 。 


B Preferences ) 
[ype fiter tex: Android 人 -cv | 
General ^ Eum E 

Android 
Buid SDK Location: G\Android\andrcid-sdk-windows (Browse. | 
DOMS Noto: The list of SDK Targets below is only reloaded once you hit Apply or 'OK'. 
Editore 
isa Target Name Vendor Platform API Level 
LogCat Android 233 Android Open Source Project 233 10 
Usage Stats Google APl« Google Inc. 233 1 

Ant Android 3.2 Android Open Source Project. 32 2 

Help Android 4.0. "Android Open Source Proje 0 这 

InsialljUpdate. Google APIs Google Inc. 40 14 

Java - 

一 一 一 


图 2.19 Eclipse 配置 界面 
至 此 ,Android 应 用 程序 的 开发 环境 就 安装 完成 了 。 后 面 的 内 容 会 对 Android SDK 
的 目录 结构 、 示 例 程 序 和 开发 工具 进行 介绍 。 
22 Andad SDK 


Android SDK 是 程序 开发 人 员 学 习 和 开发 Android 程序 的 宝贵 资源 ,不 仅 提 供 了 开 
发 所 必 备 的 调试 .打包 和 仿真 工具 ,还 提供 了 详尽 的 说 明文 档 和 简单 易 懂 的 开发 示例 。 


221 目录 结构 


在 Android SDK 安装 到 本 地 磁盘 后 ,可 以 在 文件 系统 中 查看 到 Android SDK 的 目 
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录 结 构 , 如 图 2. 20 所 示 。 


(十 )add-ons 
(十 )addon_google_apis_google_inc_-14 
(十 )docs 
(+)extras 
(十 )google 
(十 )usb_driver 


十 )platforms 
(十 )android-14 


(十 )platforms-tools 


(十 )samples 

(+ )android-14 
(+)temp 
(+ )tools 
(一 )SDK Manager. exe 
(—)AVD Manager. exe 
(一 )SDK Readme. txt 


2.20 Android SDK 的 目录 结构 


其 中 ,add-ons 目录 用 来 存放 Google 提供 的 地 图 开发 包 , 支 持 基 于 Google Map 的 地 
图 开发 。docs 目录 中 存放 的 是 Android SDK 的 帮助 文档 ,通过 目录 下 的 offline. html 文 
件 启动 ,帮助 文档 的 首页 面 如 图 2. 21 所 示 。extras\google 目录 下 保存 了 Android 手机 
的 USB 驱动 程序 。platforms 目录 用 来 存放 SDK 和 AVD 管理 器 下 载 的 各 种 版 本 的 
SDK ,笔者 的 目录 中 有 4.0 版 本 的 SDK。platforms-tools 目录 中 保存 了 与 平台 调试 相关 
的 工具 ,如 adb、aapt 和 dx 等 。samples 目录 是 示例 代码 和 程序 的 存放 目录 。temp 是 临 
时 存放 文件 的 目录 ,在 SDK 和 AVD 管理 器 下 载 开发 包 时 ,下 载 文件 会 临时 存放 在 这 个 
目录 中 。tools 目录 保存 了 通用 的 Android 开发 调试 工具 和 Android 手机 模拟 器 。SDK 
Manager. exe 和 AVD Manager. exe 分 别 是 SDK 和 AVD 的 管理 器 ,SDK Readme. txt 是 
Android SDK 的 说 明文 档 。 

Android SDK 帮助 文档 内 容 非 常 丰富 ,详细 介绍 了 Android 系统 中 所 有 API 函数 的 
使 用 方法 ,尤其 帮助 文档 中 的 开发 指南 (Dev Guide) ,系统 地 介绍 了 Android 应 用 程序 的 
开发 基础 ,用户 界 面 .资源 使 用 ,数据 存储 、 音 视频 功能 、 集 成 开发 环境 和 开发 工具 等 内 
容 , 对 于 学 习 Android 程序 开发 具有 指导 意义 。 


222 示例 程序 


在 二 Android SDK>œ\samples\android-14 目录 中 ,有 多 个 基于 Android 4. 0 版 本 的 
示例 程序 。 这 些 示 例 程序 多 数 并 不 复杂 ,但 可 以 从 不 同方 面 展示 Android SDK 所 提供 的 
丰富 功能 。 
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M | SoK DevGuide Reference Resources Videos Blog 


Wm Download 
The Andrcid SDK has the 
toos, sample code, and docs 
Weve completely redesigned Android Market you need to create great apps. 
A for phones to make it easier to explore Android 
apps, games, and cther content. Look for the 
new version coming to your Android phone! 


Developer Announcements 


Publish 


Leam more » 
ls | Android Market is an open 


senice that lets you distribute 
your apps to handsets. 


Ice Cream Sandwich! 


£. Contribute 


Oh my goodness, that looks tasty! Wt Anaoa Open Source Project 
gives you access to the entire 
platform source. 


g, Target Devices 


Æ 2.21 Android SDK 帮助 文档 


1. MultiResolution 示例 


MultiResolution 是 Android 程序 支持 不 同 尺 寸 屏幕 的 示例 。 根 据 屏幕 分 关 \ 同 ， 
Android 程序 可 以 自动 加 载 不 同 大 小 的 图 片 ,避免 图 片 尺寸 对 界面 布局 产生 影响 。 
MultiResolution 示例 如 图 2. 22 所 示 。 


2. ApiDemos 示例 


ApiDemos 示例 提供 了 Android 平台 上 多 数 API 的 使 用 方法 , 涉 \ 资 源 、 图 形 、 
搜索 .语音 识别 和 用 户 界 面 等 方面 。 程 序 开发 人 员 可 以 在 Android 应 用 程序 开发 过 程 中 
参考 ApiDemos 示例 ,但 该 示例 的 代码 文件 众多 ,结构 上 略 显 混乱 ,给 参考 和 学 习 带 来 不 
小 的 阻碍 。ApiDemos 示例 如 图 2. 23 所 示 


Animation 


App 


Content 


Graphics 


Media 


NFC 


os 


Preference 


Next 


Text 


图 2.22 MultiResolution 示例 Æ 2.23 ApiDemos 示例 
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3. SkeletonApp 示例 


SkeletonA pp 示例 是 一 个 界面 演示 程序 ,说 明了 如 何 使 用 布局 和 界面 控件 设计 用 户 
界面 ,以 及 如 何在 界面 中 添加 菜单 和 处 理 菜 单 事件 。SkeletonApp 示例 如 图 2. 24 所 示 。 


4. NotesPad 示例 

NotesPad 示例 是 一 个 记事 本 程序 ,可 以 将 文字 内 容 保存 在 记事 本 程序 中 ,并 支持 添 
加 和 删除 记事 本 操作 。NotesPad 示例 说 明了 如 何 进行 复杂 程序 设计 ,以 及 如 何 使 用 
SQLite 数据 库 保 存 数 据 和 ContentProvider 共享 数据 。NotesPad 示例 如 图 2. 25 所 示 。 


|. New note. 


Test 123 


2.24 SkeletonApp 示例 2.25 NotesPad 示例 


5. Home 示例 


Home 示例 是 一 个 桌面 主题 程序 ,可 以 将 自 定 义 的 桌面 主题 注册 到 系统 中 ,用 户 可 以 
通过 点 击 Home 键 选择 不 同 的 桌面 主题 。 此 示例 说 明了 如 何 进行 桌面 主题 程序 的 开发 ， 
以 及 在 开发 过 程 中 需要 注意 的 事项 。Home 示例 如 图 2. 26 所 示 。 


Complete action using 


[ ] Home Sample 
r 


e o 


Use by default for this action. 
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6. Snake 示例 

Snake 示例 是 贪 吃 蛇 程 序 ,一 个 经 典 的 小 游戏 ,可 以 通过 导航 键 控制 贪 吃 蛇 的 前 进 方 
向 。 该 示例 演示 了 如 何在 Android 系统 中 进行 游戏 开发 ,对 进行 游戏 开发 的 程序 人 员 具 
有 一 定 的 参考 价值 。Snake 示例 如 图 2. 27 所 示 。 

7. LunarLander 示例 

LunarLander 示例 也 是 一 个 小 游戏 ,模拟 登陆 舱 在 月 球 表面 着 陆 。 用 户 通 过 控制 登 


陆 舱 的 方向 和 速度 ,使 登陆 舱 可 以 平稳 地 在 月 球 表面 着 陆 。LunarLander 示例 实现 了 简 
单 的 碰撞 检测 功能 ,值得 游戏 开发 人 员 学 习 和 参考 。LunarLander 示例 如 图 2. 28 所 示 。 


Lunar Lander 
Press Up To Play 


Pr = a 
2.27 Snake 示例 2.28  LunarLander 示例 
8. JetBoy 示例 


JetBoy 示例 是 一 个 支持 背景 音乐 和 音效 的 游戏 程序 ,用 户 可 以 控制 飞船 击 碎 飞 来 的 
陨石 。JetBoy 示例 如 图 2. 29 所 示 。 


2.29 JetBoy 示例 
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223 开发 工具 


Android SDK 提供 了 多 个 强大 的 开发 工具 ,便于 程序 开发 人 员 简 化 开发 和 调试 过 
程 。 这 些 工具 中 多 数 可 以 在 Eclipse 中 直接 调用 ,也 有 部 分 是 需要 在 命令 行 模式 下 使 用 
的 ,后 面 的 内 容 将 逐个 介绍 这 些 工具 。 


1. Android 模拟 器 


Android SDK 中 最 重要 的 工具 就 是 Android 模拟 器 ,如 图 2. 30 所 示 , 允许 程序 开发 
人 员 在 没有 物理 设备 的 情况 下 ,在 电脑 上 对 Android 程序 进行 开发 .调试 和 仿真 。 


0000 


opo 
@@eaQ 


[dzs ls ls le lz 


lo |» | 
mE 
mam 
Lalo | | | 


2.30 Android 模拟 器 


Android 模拟 器 可 以 仿真 手机 的 绝 大 部 分 硬件 和 软件 功能 ,支持 加 载 SD 卡 映像 文 
件 ,更 改 模拟 网 络 的 状态 .延迟 和 速度 ,模拟 电话 呼叫 和 接收 短信 等 ,支持 将 屏幕 当成 触 
摸 屏 使 用 ,可 以 使 用 鼠标 点 击 屏幕 来 模拟 用 户 对 Android 设备 的 触摸 操纵 。 在 Android 
模拟 器 上 有 普通 手机 常见 的 各 种 按键 ,如 音量 键 , 挂 断 键 、 返 回 键 和 菜单 键 等 。 但 目前 为 
止 ,Android 模拟 器 仍 不 支持 的 功能 包括 接听 真实 电话 呼叫 .USB 链接 、 摄 像 头 捕获 、 连 
接 状 态 检测 .电池 电量 、.AC 电源 检测 .SD 卡 插 拔 检查 和 蓝牙 设备 等 。 

Android 模拟 器 还 支持 多 种 屏幕 分 辩 率 和 不 同 的 外 观 , 表 2. 1 列举 了 Android SOK 
4.0 版 本 所 支持 的 屏幕 分 辩 率 。 


2. Android iE iX EF 


Android 调试 桥 (Android Debug Bridge. ADB) 是 用 于 连接 Android 设备 或 模拟 器 的 
工具 ,负责 将 应 用 程序 安装 到 模拟 器 和 设备 中 ,从 模拟 器 或 设备 中 传输 文件 。Android 调 
试 桥 是 一 个 客户 端 /服务 器 程序 ,包含 守护 程序 服务器 程序 和 客户 端 程序 。 守 护 程序 
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表 2.1 Android 模拟 器 外 观 
类 型 | 分 9" 率 说 上 明 类 型 | 分 5 ox 说 明 


QVGA 240X320 | 低 分 辩 率 ,小 屏幕 WVGAS54 | 480X854 高 分 辩 率 ,中 屏幕 
WQVGA400 | 240X400 | 低 分 辩 率 ,中 屏幕 WVGA720 | 1280X720 | 较 高 分 辩 率 ,中 屏幕 
WQVGA432 | 240X432 | 低 分 辩 率 ,中 屏幕 WSVGA 1024X600 | 中 等 分 辩 率 ,大 屏幕 
HVGA 320X480 | 中 等 分 辩 率 ,中 屏幕 | WXGA 1280X800 | 中 等 分 辩 率 ,大 屏幕 
WVGAS800 480X800 | 高 分 辩 率 ,中 屏幕 


运行 在 每 个 模拟 器 的 后 台 ; 服 务 器 程序 运行 在 开发 环境 中 ,管理 客户 端 和 守护 程序 的 连 
接 ;客户 端 程序 通过 服务 器 程序 ,与 模拟 器 中 的 守护 程序 相连 接 。 


3. DDMS 


DDMS(Dalvik Debug Monitor Service) 是 Android 系统 中 内 置 的 调试 工具 ,可 以 用 
来 监视 Android 系统 中 进程 ,堆栈 信息 ,查看 logcat 日 志 , 实 现 端口 转发 服务 和 屏幕 截图 
功能 ,模拟 电话 呼叫 和 SMS 短信 ,以 及 浏览 Android 模拟 器 文件 系统 等 。DDMS 的 启动 
文件 是 二 Android SDK 二 /tools/ddms. bat, 

在 Eclipse 中 , 通过 Window Open 
= Perspective> Other DDMS 打开 DDMS 调试 
r Ep 界面 ,然后 通过 Window Show view Other 
"py 打开 Show View 的 选择 对 话 框 ,如 图 2. 31 所 

ce 示 。 这 样 就 可 以 在 DDMS 调试 界面 中 添加 任 

人 何 希 望 进行 调 坛 和 检查 的 功能 。 

& ipit " DDMS 中 的 设备 管理 器 (Devices) ,可 以 同 

Use F2 to display the description for a selected vie. | 时 监控 多 个 Android 模拟 器 ,显示 每 个 模拟 器 

Coxa J| 中 所 有 正在 运行 的 进程 。 模 拟 器 使 用 端口 号 进 

行 唯一 标识 ,例如 ,监听 端口 是 5554 的 模拟 器 

标识 为 emulator-5554。 在 选择 指定 的 进程 后 ， 

可 以 通过 右上 角 的 按钮 刷新 进程 中 线程 和 堆栈 

的 信息 ,或 是 单 击 STOP 按钮 关闭 指定 进程 。 另 外 ,这 里 还 提供 屏幕 截图 功能 ,可 以 将 

Android 模拟 器 当前 的 屏幕 内 容 保存 成 png 文件 。DDMS 中 的 设备 管理 器 如 图 2. 32 
所 示 。 


É Show View 


In 


图 2.31 Show View 选择 对 话 框 


Androidl.5. 
IE E] 


com. android inputmethod latin 763 8608 


A 2.32 DDMS 中 的 设备 管理 器 
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DDMS 中 的 模拟 器 控制 器 (Emulator ControD ,可 以 控制 Android 模拟 器 的 网 络 速 
度 和 延迟 ,模拟 语音 和 SMS 短信 通信 。 模 拟 器 控制 器 支持 的 网 络 速率 包括 GSM, 
HSCSD,PRS,EDGE,MTS,DPA 和 全 速率 ,支持 的 网 络 延 迟 有 GPRS,EDGE,UMTS 和 
无 延迟 。DDMS 中 的 模拟 器 控制 器 如 图 2. 33 所 示 。 


国 zuater Cote B > p 


20 


Telephony Status 

Voice: [hone Speed: [ru 国 | 
Data: [hone | Latency: [EEE v) 
Telephony Actions 

Incoming number: 13600001111 

O 〇 voice 

Qsis 


Message: [neo Sus 


图 2.33 DDMS 中 的 模拟 器 控制 器 


在 Telephony Actions 框 中 的 Incoming number 文本 框 中 输入 电话 号 码 , 然 后 选择 
Voice( 语 音 呼叫 ) 单 选项 , 单 击 Send 按钮 后 ,模拟 器 就 可 以 接收 到 来 自 输 入 电话 号 码 的 
语音 电话 ,如 图 2. 34(a) 所 示 。 如 果 选 择 SMS( 短 信 ) 单 选项 ,在 Message 文本 框 中 填 人 
短信 的 内 容 , 模 拟 器 就 可 以 接收 来 自 输入 电话 号 码 的 SMS 短信 ,如 图 2. 34(b) 所 示 。 


& 
13600001111 z Messaging ] 
13600001111 
Hello SM: BASAN 
á 
s, Q 
(2) 电话 呼 入 (b) SMS 短 信 


图 2.34 Android 电话 呼 入 和 SMS 短信 


DDMS 中 的 文件 浏览 器 (File Explorer) ,可 以 对 Android 内 置 存 储 器 上 的 文件 进行 
上 传 .下 载 和 删除 等 操作 ,还 可 以 显示 文件 和 目录 的 名 称 、 权 限 、 建 立时 间 等 信息 。DDMS 
中 的 文件 浏览 器 如 图 2. 35 所 示 。 

DDMS 中 的 日 志 浏 览 器 (LogCat), 可 以 浏览 Android 系统 、Dalvik 虚拟 机 和 应 用 程 
序 产 生 的 日 志 信息 ,有 助 于 快速 定位 应 用 程序 产生 的 错误 。DDMS 中 的 日 志 浏 览 器 如 
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图 2. 36 所 示 。 


B © data 
B 包 mr 
um Gp 
B Qo epp-privete 
国 © dalvik-cach. 
B 包 dete 
B QR local 
国 色 lostkfound 
国 久 nise 
B & property 
E y systen 

B sdcard 

i QR systen 


图 2.35 DDMS 中 的 文件 浏览 器 
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| tag 


| Message. El 


NotificationService 
NotificationService 
TrackingPatternViev 
TrackingPatternViev 
ActivityManager 
ActivityManager 
dalvikvm 

dalvikva 

dalvikva 
KeyCharacterMap 
KeyCharacterMap 
SnsProvider 
ActivityManager 


at android media AsyncPlayerSThread run(AsyncPlay 
STOP command vithout a player 
vidth*320 textureVidth-120 
vidth*320 textureVidth*120 
Starting activity; Intent { action*android. intent act 
Displayed activity com.android.mxs/.ui.Composeessage 
GC freed 5682 objects / 358168 bytes in 126ns 
GC freed 1086 objects / 48592 bytes in 104ns 
GC freed 557? objects ^ 230320 bytes in 120ns 
No keyboard for id 0 


Using default keymap: /system/usr/keychars/qwerty ko | 
insert url=content://sns/outbox. match*8 
Stopping service: com android mns/ transaction Snsrec| 


图 2.36 DDMS 中 的 日 志 浏览 器 


除了 上 面 介绍 的 功能 外 ,DDMS 还 能 够 查看 虚拟 机 的 堆栈 状态 、 线 程 信息 和 控制 台 
信息 。 由 此 可 见 ,DDMS 是 进程 调试 和 错误 定位 的 强大 工具 。 


4. 其 他 工具 


为 了 便于 Android 程序 开发 , Android SDK 还 提供 了 一 些小 工具 。 这 些 工具 的 名 
称 、 用 途 和 启动 文件 可 以 参考 表 2. 2。 


表 2.2 Android SDK 提供 的 其 他 工具 


工具 名 称 启动 文件 说 明 
数据 库 工具 sqlite3. exe 用 来 创建 和 管理 SQLite 数据 库 
打包 工具 ápkbuilder. bat 将 应 用 程序 打包 成 apk 文件 
E: " : 对 用 户 界面 进行 分 析 和 调试 ,以 图 形 化 的 方式 展示 
层级 观察 器 hierarchyviewer. bat 树 型 结构 的 界面 布局 
跟踪 显示 工具 ncc eR 以 图 形 化 的 方式 显示 应 用 程序 的 执行 日 志 , 用 来 调 


试 应 用 程序 ,分 析 执行 效率 


工具 名 称 


启动 文件 
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续 表 
说 M 


SD 卡 映像 创建 工具 


mksdcard. exe 


建立 SD 卡 的 映像 文件 


NinePatch 文件 编辑 
工具 


draw9patch, bat 


NinePatch 是 Android 提供 的 可 伸缩 的 图 形 文件 格 
式 , 基 于 PNG 文件 。draw9patch 工具 可 以 使 用 
WYSIWYG 编辑 器 建立 NinePatch 文件 


经 过 zipalign 优化 过 的 APK 程序 ,Android 系统 可 
更 高 效 地 根据 请 求索 引 APK 文件 中 的 资源 。 使 用 


PK 乱用 优化 内。 eipilign exe 4 字 节 的 边界 对 齐 方式 来 映射 内 存 ,通过 空间 换 时 
间 的 方式 提高 执行 效率 
| 通过 删除 未 使 用 的 代码 ,并重 命名 代码 中 的 美 \ 字 


段 和 方法 名 称 ,使 代码 较 难 实施 逆向 工程 


PNG 和 ETCI 转换 工具 


etcltool. exe 


命令 行 工 具 , 支 持 将 PNG 和 ETC1 相互 转换 


Monkey ( 通 过 adb 


Monkey 可 在 模拟 器 或 设备 上 产生 随机 操作 事件 ， 


界面 操作 测试 工具 运行 ) 包括 点 击 .触摸 或 手势 等 ,用 于 对 程序 的 用 户 界 面 
i 进行 随机 操作 测试 
模拟 器 控制 工具 monkeyrunner. bat 允许 通过 代码 或 命令 ,在 外 部 控制 模拟 器 或 设备 


z 


z 


1. 尝试 安装 Android 开发 环境 ,并 记录 安装 和 配置 过 程 中 所 遇 到 的 问题 。 
2. 浏览 Android SDK 帮助 文档 ,了 解 Android SDK 帮助 文档 的 结构 和 用 途 。 


3. 在 Android SDK 中 ,Android 模拟 器 、Android 调试 桥 和 DDMS 是 Android 应 用 


程序 开发 过 程 中 经 常 使 用 的 工具 , 简 述 这 三 个 工具 的 用 途 。 


第 一 个 Android 程序 


本 章 主要 介绍 开发 Android 应 用 程序 的 基础 知识 和 基本 方法 。 通 过 本 章 内 容 的 学 
2] ,读者 可 以 掌握 使 用 Eclipse 开发 Android 应 用 程序 的 过 程 和 方法 ,了 解 Android 应 用 
程序 的 目录 结构 和 自动 生成 文件 的 作用 。 学 习 如 何 使 用 命令 行 创建 Android 应 用 程序 ， 
有 助 于 深入 理解 Android 程序 的 生成 、 安 装 和 运行 过 程 。 

本 章 学 习 目 标 ， 

。 掌握 使 用 Eclipse 开发 Android 应 用 程序 的 方法 ; 

* 掌握 Android 虚拟 设备 (AVD) 的 创建 方法 ; 

。 了 解 R. java 文件 的 用 途 和 生成 方法 ; 

* 了 解 AndroidManifest. xml 文件 的 用 途 ; 

。 了 解 Android 的 程序 结构 ; 

。 了 解 使 用 命令 行 创建 Android 程序 方法 。 
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本 节 将 介绍 如 何 使 用 Eclipse 集成 开发 环境 建立 第 一 个 Android 程序 
HelloAndroid。 首 先 启动 Eclipse, 显示 的 集成 开发 环境 如 图 3.1 所 示 。 如 果 在 
Eclipse 中 建立 过 Android 工程 ,工程 名 称 和 目录 结构 将 显示 在 Package Explorer 区 
域内 。 

有 两 种 方法 可 以 打开 Android 工程 向 导 , 一 种 是 以 File New-* Project | Android 
— Android Project 的 顺序 , 另 一 种 是 以 File New 一 Other*…| Android — Android 
Project 的 顺序 。 两 种 方法 只 是 选择 的 顺序 不 同 , 结 果 是 相同 的 。 在 第 二 种 方法 中 ,除了 
可 以 建立 Android 工程 外 向 导 , 还 可 以 建立 Android 示例 工程 ,就 是 保存 在 二 Android 
SDK 二 /samples 目录 中 的 示例 。 如 图 3. 2 所 示 , 选 择 Android Project 建立 Android 
工程 。 

在 Android 工程 向 导 中 ,第 一 步 需 要 输入 工程 名 称 (project name) ,工程 名 称 必须 唯 
一 ,不 能 与 已 有 的 工程 名 称 重复 ,这 里 填 和 人 HelloAndroid 作为 工程 名 称 。 新 建 的 工程 被 
保存 在 默认 的 工作 空间 中 ,笔者 的 工作 空间 是 G:/Android/workplace, 所 以 将 
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Navigate Search Project Refactor Window Help 
es BB Bs *-O-Q- EG- OSF- m Ema) ooMs t Debug 


月 Package Explorer 器 N 2y Sg 
egle? 


图 3.1 Eclipse 集成 开发 环境 


type filter text 


b (& General 
4 (& Android 
Q Android Icon Set 
3 Android Sample Project 
JG Android Test Project 
Id Android XML File 
E Android XML Layout File 
[d Android XML Values File 
5 & CVs 
b © Java 


| o <te jb) [Er | 


图 3.2 Eclipse 工程 向 导 


HelloAndroid 工程 保存 在 G:/Android/workplace/ HelloAndroid, 如 图 3. 3 所 示 。 当 然 ， 
也 可 以 取消 Use default location 复 选 框 ,选择 其 他 位 置 保存 Android 工程 。 

第 二 步 是 选择 程序 运行 的 Android 系统 版 本 。 如 图 3. 4 所 示 , 笔 者 的 系统 中 有 
Android 4. 0 和 Google APIs 两 个 Android SDK。 这 里 选择 Android 4. 0, 以 4.0 版 本 
Android 系统 为 例 ,完成 第 一 个 Android 应 用 程序 的 开发 。 

在 图 3.4 中 ,除了 在 Platform 属性 中 标识 Android 系统 的 版 本 外 ,还 有 一 个 API 
LevelCAPI 等 级 ) 的 属性 。API 等 级 是 Android 系统 中 用 来 标识 API 框架 版 本 的 一 个 整 
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r 
dp New Android "roc n 
i 
Create Android Project 
Select project name and type of project 


Project Name: HelloAndroid| 

© Create new project in workspace 

Create project from existing source 

© Create project from existing sample 

F Use default location. 

Location: — [GyAndroid/workplace/HelloAndroid | [Browse..] 
Working sets 


E Add project to working sets 


Warking sets: [ 


3.3 Android 工程 向 导 


4B New Android Project. 


Select Build Target 
Choose an SDK to select a sample from 


Build Target 


Target Name Vendor Platform API 
M earsid4o [Andes OpenScacePmjst — 140 EN 
Google APIs Google Inc. 40 14 


[ 


@ Bak [Netz | Eirish Camel |] 


图 3.4 Android 工程 向 导 


数 , 用 来 识别 Android 程序 的 可 运行 性 。 如 果 Android 程序 标识 的 API 等 级 高 于 
Android 系统 所 支持 的 API 等 级 ,程序 则 无 法 在 该 Android 系统 中 运行 。API 等 级 与 系 
统 版 本 之 间 的 对 照 关 系 可 参考 表 3. 1。 

第 三 步 填写 应 用 程序 名 称 (Application name) ,应 用 程序 名 称 是 Android 程序 在 手 
机 或 模拟 器 中 显示 的 名 称 ,程序 运行 时 也 会 显示 在 屏幕 项 部 。Eclipse 会 自动 将 工程 名 称 
填写 在 应 用 程序 名 称 这 一 栏 中 ,用 户 可 以 不 用 更 改 , 使 用 这 个 推荐 设置 ,如 图 3. 5 所 示 。 
当然 ,用 户 也 可 以 使 用 中 文 的 应 用 程序 名 称 , 如 “第 一 个 Android 程序 ”等 。 
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表 3.1 API 等 级 对 照 表 
系统 版 本 API 等 级 版 本 代号 支持 设备 类 型 

Android 4. 0 14 ICE CREAM SANDWICH iid 
Android 3. 2 13 HONEYCOMB MR2 平板 电脑 
Android 3. 1. x 12 HONEYCOMB MRI 平板 电脑 
Android 3. 0. x 11 HONEYCOMB 平板 电脑 
etr E $ 10 GINGERBREAD_MR1 智能 手机 
Android 2. 3.2 

Android 2. 3. 1 9 GINGERBREAD 智能 手机 
Android 2.3 

Android 2. 2. x 8 FROYO 智能 手机 
Android 2. 1. x 7 ECLAIR MRI 智能 手机 
Android 2. 0. 1 6 ECLAIR 0 1 智能 手机 
Android 2.0 5 ECLAIR 智能 手机 
Android 1.6 4 DONUT 智能 手机 
Android 1.5 3 CUPCAKE 智能 手机 
Android 1.1 2 BASE 1 1 智能 手机 
Android 1.0 1 BASE 智能 手机 


包 名 称 (Package name) 是 包 的 命名 空间 ,需要 遵循 Java 包 的 命名 方法 。 包 名 称 由 两 


| Application Info 
|| Configure the new Android Project 


| Package Name: 


Application Name: HelloAndroid 


| edu hrbeu.HelloAndroid| 


Minimum SDK: — 14 


|| E Create a Test Project. 


Test Project Name: | HelloAndroidTest 


Test Application: 


HelloAndroidTest 


图 3.5 Android 工程 向 导 


38 


A (第 2 版 ) 


个 或 多 个 标识 符 组 成 ,中 间 用 点 隔 开 ,例如 hrbeu. HelloAndroid。 使 用 包 主 要 为 了 避免 
命名 冲突 ,因此 可 以 使 用 反 写 电子 邮件 地 址 的 方式 保证 命名 的 唯一 性 ,例如 笔者 的 电子 
邮件 地 址 是 wangxianghui@ hrbeu. edu. cn, 则 可 以 将 包 名 称 命名 为 cn. edu. hrbeu 
. wangxianghui。 为 了 保证 代码 的 简洁 ,第 一 个 Android 程序 的 包 名 称 使 用 edu. hrbeu 
. HelloAndroid 。 

创建 Activity(Create Activity) 是 一 个 可 选项 ,如 果 需 要 自动 生成 一 个 Activity 的 代 
码 文件 , 则 需要 选择 该 项 ,否则 可 以 不 选 。Activity 主要 用 于 管理 用 户 界 面 ,后续 章 节 会 
做 详细 介绍 ,这 里 选择 该 项 。Eclipse 会 自动 以 “应 用 程序 名 称 十 Activity” 作 为 Activity 
的 名 称 , 所 以 这 里 的 Activity 的 名 称 为 HelloAndroidActivity。 

SDK 最 低 版 本 (Minimum SDK) 指 的 是 Android 程序 能 够 运行 的 最 低 的 API 等 级 ， 
如 果 手 机 中 的 Android 系统 的 API 等 级 低 于 程序 的 SDK 最 低 版 本 , 则 程序 不 能 够 在 该 
Android 系统 中 运行 。 在 选择 Build Target 时 ,SDK 最 低 版 本 已 被 自动 填 人 14, 此 项 无 
须 更 改 。 

最 后 单 击 Finish 按钮 ,工程 向 导 会 根据 用 户 所 填写 的 Android 工程 信息 ,自动 在 后 
台 创 建 Android 工程 所 需要 的 基础 文件 和 目录 结构 。 当 创建 过 程 结束 ,用 户 将 看 
到 图 3.6 所 示 的 内 容 。 


ER Et Ben ource- Mage -Sopak project Rakaan Modom Hep 
2d EATA IAB Bud *-O-qQ- BO. SOF. PAVEN BERO Hoeg 
ipti mers 


(T hetoandroidactiityjove SS E 


ERI. | sedere edu.hrbeu.Mellotndroid; 


"wea 


4 i) HoloAndroid 


@ inport androia. agp. Activityi[ 


4 dB eduhrbeuHeloAndroid 
+ [E HelcAndroidActivityjava 
4 È$ aen [Gererated Java Files) 
> B eduhrbeuHeloandroid 
4 ah Android 40 
> B androidjar - GAAndroid\ardroil 
Es assets 


| 区 robiems [@ Javadoc E Declaration | © Console 15 
android 


3.6 HelloAndroid 工程 的 文件 和 目录 结构 


用 户 无 须 在 HelloAndroid 工程 中 添加 任何 代码 , 即 可 运行 HelloAndroid 程序 。 但 
为 了 让 Android 程序 能 够 正常 运行 ,必须 先 建立 Android 虚拟 设备 (Android Virtual 
Device. AVD). 

AVD 是 对 Android 模拟 器 进行 自 定义 的 配置 清单 ,能 够 配置 Android 模拟 器 的 硬 
件 列表 、 模 拟 器 的 外 观 、 支 持 的 Android 系统 版 本 .附件 加 SDK 库 和 存储 设置 等 信息 。 
在 用 户 配 置 好 AVD 后 , Eclipse 就 可 以 按照 用 户 的 要 求 启动 特定 版 本 和 硬件 特征 的 
Android 模拟 器 。 配 置 AVD 的 最 简单 的 方式 是 通过 Eclipse 的 Window > AVD 
Manager 命令 启动 AVD 管理 器 ,如 图 3.7 所 示 。 


zx 


Android Virtual Device 


List of existing Android Virtual Devices located at C:\Users\Administrator\.android\avd 


Target Name 
No AVD available 


AVD Name Platform 


API Level CPU/ABI 


v A valid Android Virtual Device. F A repairable Android Virtual Device. 
X An Android Virtual Device that failed to load. Click 'Details to see the error. 


3.7 AVD 管理 器 


在 AVD 管理 器 点 击 New 按钮 ,打开 AVD 创建 界面 ,如 图 3. 8 所 示 。 用 户 需 要 在 


Name 文本 框 中 输入 AVD 的 名 称 ,为 了 便于 区 分 多 个 AVD 的 用 途 ， 


会 体现 Android 的 版 本 信息 ,图 3. 8 中 建立 名 为 
AndroidSim4. 0 的 AVD。Target 是 AVD 支持 
的 Android 系统 ,这 里 选择 Android 4. 0-API 
Level 14。SD Card 框 中 输入 128 ,表示 在 模拟 器 
中 将 模拟 一 个 大 小 为 128M 的 SD 卡 。Skin 表 
示 模 拟 器 的 外 观 , 默认 选择 为 Default 
(WVGA800) ,支持 的 分 辩 率 为 480 X 800。 在 
Hardware 框 中 可 以 添加 Android 模拟 器 的 硬件 
特性 ,在 没有 特别 要 求 的 情况 下 ,可 以 使 用 默认 
设置 。 完 成 AVD 的 配置 后 , 单 击 Create AVD 
按钮 保存 AVD 的 配置 信息 ,然后 在 AVD 管理 
器 单 击 Start 按钮 启动 Android 模拟 器 。 

在 启动 Android 模拟 器 前 ,用 户 还 须 在 
Launch Options 中 确认 启动 项 .包括 将 显示 尺寸 
缩放 到 实际 屏幕 尺寸 和 删除 模拟 器 中 原 有 数据 ， 
以 及 从 快照 点 启动 和 存储 快照 等 。Launch 
Options 的 界面 如 图 3. 9 所 示 。 

使 用 Eclipse 运行 Android 程序 非常 简单 ， 
只 要 通过 菜单 Run- Run| Android Application 


一 般 在 AVD 命名 时 


Androidsim4.0 


[Android 4.0 - API Level 14. 


E [ARM (armeabi-v7a) 


@ Size 128 


Ofle: | 


B Enabled 


@ Built-in: 


C eii [ " 
Hardware: 

Property 

Abstracted LCD density 


Mex VM application h.. 24 
Device ram size. 


DD Override the existing AVD with the same name 


[gene seo ] cmn 


3.8 AVD 创建 界面 


3k Run- Debug Android Application 便 可 运行 Android 程序 。 启 动 Android 模拟 器 是 
一 个 缓慢 的 过 程 ,程序 调试 完毕 后 ,不 必 关 闭 Android 模拟 器 ,可 以 节约 下 次 程序 调试 时 
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启动 模拟 器 的 时 间 。Eclipse 会 自动 完成 Android 程序 编译 .打包 和 上 传 等 过 程 , 并 将 程 
序 的 运行 结果 显示 在 模拟 器 中 。HelloAndroid 程序 的 运行 结果 如 图 3. 10 所 示 。 


^ 
dB Launch Options [77 


Skin: — WVGABOO (480x800) 
Density: High (240) 


"cale dispiay to real size 


96 


[E Wipe user data 
Launch from snapshot 


Save to snapshot 


EE Bee 


图 3.9 Launch Options 界面 图 3.10 HelloAndroid 的 运行 结果 


可 以 通过 菜单 Run Run Configuration 或 Run Debug Configuration 来 配置 模拟 
器 的 运行 选项 。 图 3. 11 是 Run Configurations 的 启动 选项 ,能够 选择 不 同 的 AVD, 配置 
网 络 速度 .网 络 延 迟 .控制 台 的 字符 编码 和 标准 输入 输出 等 内 容 。 一 般 情 况 下 ,只 要 正确 
选择 AVD 即 可 ,其 他 选项 可 以 不 做 任何 修改 。 
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图 3.11 启动 选项 


到 这 里 已 经 完成 了 第 一 个 Android 程序 ,并 得 到 了 程序 的 运行 结果 ,对 如 何 建立 和 
运行 Android 程序 已 经 有 了 基本 的 了 解 。 后 面 的 内 容 仍 然 以 HelloAndroid 为 例 , 介 绍 
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Android 程序 的 目录 结构 和 文件 用 途 。 


32 Andod 程 序 结构 


在 建立 HelloAndroid 程序 的 过 程 中 ,ADT 会 自动 建立 一 些 目 录 和 文件 ,如 图 3. 12 
所 示 。 这 些 目录 和 文件 有 其 固定 的 作用 ,有 的 允许 修改 ， 


H Package Explorer 22 =p 
有 的 则 不 能 进行 修改 ,了 解 这 些 文件 和 目录 ,对 Android B&le" 
程序 开发 有 着 非常 重要 的 作用 。 Paar 
TE Package Explore 中 ,ADT 以 工程 名 称 HelloAndroid 和 Eye m 


作为 根 目录 ,将 所 有 自动 生成 的 和 非 自 动 生成 的 文件 都 EB om ete aite 


Æ edu.hrbeu.HelloAndroid 


保存 在 这 个 根 目 录 下 。 根 目录 下 包含 5 个 子 目 录 src、 国 em 


BÀ Android 4.0 
gen.assets, bin 和 res. 1 个 库 文件 android. jar, 以 及 3 个 B endroidjer -Gyadoldvndnoid 
工程 文件 AndroidManifest. xml, project. properties 和 pr 
proguard. cfg。 = drawable-hdpi 

src 目录 是 源 代码 目录 ,所 有 人 允许 用 户 修改 的 java X ss 
件 和 用 户 自 己 添加 的 java 文件 都 保存 在 这 个 目录 中 。 M 
HelloAndroid 工程 建立 初期 ,ADT 根据 用 户 在 工程 向 导 er 
中 的 Create Activity 选项 , 自动 建立 HelloAndroid- siman 
Activity. java 文件 。 fi) stringsxml 


El] AndroidManifestxml 


gen 目录 用 来 保存 ADT 自动 生成 的 java 文件 ,例如 reme 
R. java 或 AIDL 文件 。 这 个 目录 中 的 文件 不 建议 用 户 进 — 
REL AT MEL ULTRA 
— d yas 3.12 HelloAndroid 工程 
动 再 次 生成 被 删除 的 文件 。 的 目录 和 文件 

assets 目录 用 来 存放 原始 格式 的 文件 ,例如 音频 文 
件 .视频 文件 等 二 进 制 格式 文件 。 此 目录 中 的 资源 不 能 够 被 R. java 文件 索引 ,因此 只 能 
以 字 节 流 的 形式 进行 读 取 。 默 认为 空 目 录 。 

bin 目录 保存 了 编译 过 程 中 产生 的 文件 ,以 及 最 终生 成 的 apk 文件 。 

res 目录 是 资源 目录 ,Android 程序 所 有 的 图 像 .颜色 .风格 .主题 .界面 布局 和 字符 串 
等 资源 都 保存 在 其 下 的 几 个 子 目录 中 。 其 中 , drawable-hdpi、 drawable-mdpi 和 
drawable-ldpi 目录 用 来 保存 同一 个 程序 中 针对 不 同 屏幕 尺寸 需要 的 不 同 大 小 的 图 像 文 
件 ,layout 目录 用 来 保存 与 用 户 界面 相关 的 布局 文件 ,values 目录 保存 颜色 、 风 格 、 主 题 和 
字符 串 等 资源 。 在 HelloAndroid 工程 中 ,ADT 在 每 个 drawable 目录 中 自动 引入 了 一 个 
不 同 尺寸 的 icon. png X ff. Android 系统 会 根据 目标 设备 的 屏幕 分 辨 率 ,为 
HelloAndroid 程序 加 载 不 同 尺寸 的 图 标 文件 ;在 layout. 目录 生成 了 main. xml 文件 ,用 
以 描述 图 3.10 所 显示 的 用 户 界面 ;在 values 目录 生成 了 strings. xml 文件 ,将 应 用 程序 
名 称 HelloAndroid 和 界面 显示 的 “Hello World. HelloAndroidActivity !” DA F ff 88 W JÉ 
式 保存 在 这 个 文件 中 。 

android. jar 文件 是 Android 程序 所 引用 的 函数 库 文件 .Android 系统 所 支持 的 API 
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都 包含 在 这 个 文件 中 ,具体 内 容 参 考 附录 B. 

proguard. cfg 文件 是 供 ProGuard 工具 进行 代码 优化 和 代码 混淆 的 配置 文件 。 

project. properties 文件 记录 了 Android 工程 的 相关 设置 ,例如 编译 目标 和 apk 设置 
等 ,该 文件 不 能 手工 修改 。 如 果 需 要 更 改 其 中 的 设置 ,必须 通过 右 击 工程 名 称 , 选 择 
Properties 进行 修改 。 从 project. properties 文件 的 代码 中 可 以 发 现 , 大 部 分 内 容 都 是 注 
释 , 仅 有 第 12 行 是 有 效 代码 ,指定 Android 程序 的 编译 目标 。 

project. properties 文件 的 代码 如 下 。 


1  #Tis file is autamatically generated by Android Tools. 

2 # Do not modify this file - - YOUR CHANGES WILL BE ERASED! 

3 * 

4 # This file mist be checked in Version Control Systems. 

5 + 

6 # To custamize properties used by the Ant build system use, 

E # "build.properties", and override values to adapt the script to your 
8 # project structure. 

9 


ll  £Project target. 
12  target-android- 14 


AndroidManifest, xml 是 XML 格式 的 Android 程序 声明 文件 ,包含 了 Android 系统 
运行 Android 程序 前 所 必须 掌握 的 重要 信息 ,这 些 信息 包括 应 用 程序 名 称 、 图 标 、 包 名 
称 \ 模 块 组 成 .授权 和 SDK 最 低 版 本 等 ,而 且 每 个 Android 程序 必须 在 根 目 录 下 包含 一 
个 AndroidManifest. xml 文件 。XML 是 一 种 可 扩展 标记 语言 ,本 身 独 立 于 任何 编程 语 
言 ,能 够 对 复杂 的 数据 进行 编码 , 且 易 于 理解 。Android 工程 中 多 处 使 用 了 XML 文件 ， 
使 应 用 程序 开发 更 加 具有 弹性 , 且 易 于 后 期 的 维护 和 理解 。 

AndroidManifest. xml 文件 的 代码 如 下 。 


<?xml version- "1.0" encoding- "utf- 8"?> 

«manifest xmlns:android- "http: //schemas .android.oaw'apk/res/android" 
package- "edu.hrbeu. Hel loAndroid" 
android:versionCode- "1" 


1 

2 

3 

4 

5 android:versionName- "1.0"> 
6 < application android:icon- "@ drawable/icon" 

7 android:label- "8 string/app name" 
8 «activity android:name- ".Hellohniroidhctivity" 

9 android:label- "@ string/app name" 
10 « intent- filter» 


E 


< action android:name- "android. intent .action.MAIN"/> 
12 < category android:name- "android. intent .category 
.IAUNCHER"/> 
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13 < /intent- filter» 
14 < /activity> 

15 < /application» 

16 < uses- sdk android:minsdkVersion= "14"/> 
17 < /mnifest> 


在 AndroidManifest. xml 文件 中 , 根 元 素 是 manifest, 包含 了 xmlns: android, 
package、android:versionCode 和 android: versionName JE 4 个 属性 。 其 中 ,第 2 行 属性 
xmlns:android 定义 了 Android 的 命名 空间 , 值 为 http://schemas. android. com/apk/ 
res/android; 第 3 行 属 性 package 定义 了 应 用 程序 的 包 名 称 ; 第 4 行 属 性 android: 
versionCode 定义 了 应 用 程序 的 版 本 号 ,是 一 个 整数 值 ,数值 越 大 说 明 版 本 越 新 ,但 仅 在 
程序 内 部 使 用 ,并 不 提供 给 应 用 程序 的 使 用 者 ;第 5 行 属性 android: versionName 定义 了 
应 用 程序 的 版 本 名 称 , 是 一 个 字符 串 , 仅 限于 为 用 户 提供 一 个 版 本 标识 。 

manifest 元 素 仅 能 包含 一 个 application 元 素 ,application 元 素 中 能 够 声明 Android 
程序 中 最 重要 的 4 个 组 成 部 分 ,包括 Activity, Service, BroadcastReceiver 和 
ContentProvider, 所 定义 的 属性 将 影响 所 有 组 成 部 分 。 第 6 行 属 性 android:icon 定义 了 
Android 应 用 程序 的 图 标 ,其 中 @drawable/icon 是 一 种 资源 引用 方式 ,表示 资源 类 型 是 
图 像 ,资源 名 称 为 icon, 对 应 的 资源 文件 为 icon. png. 目录 是 res/drawable-hdpi, res/ 
drawable-mdpi 和 res/drawable-ldpi, 这 三 个 目录 中 的 资源 仍 可 通过 @drawable 进行 调 
用 ;第 7 行 属性 android:label 则 定义 了 Android 应 用 程序 的 标签 名 称 。 

activity 元 素 是 对 Activity 子 类 的 声明 ,不 在 AndroidManifest. xml 文件 中 声明 的 
Activity 将 不 能 够 在 用 户 界面 中 显示 。 第 8 行 属性 android: name 定义 了 实现 Activity 
类 的 名 称 ,可 以 是 完整 的 类 名 称 , 如 edu. hrbeu. HelloAndroidActivity, 也 可 以 是 简化 后 
的 类 名 称 , 如 . HelloAndroidActivity; 第 9 行 属性 android: label 则 定义 了 Activity 的 标 
签名 称 ,标签 名 称 将 在 用 户 界面 的 Activity 上 部 显示 ,@string/app_name 同样 属于 资源 
引用 ,表示 资源 类 型 是 字符 串 ,资源 名 称 为 app_name. 资 源 保存 在 res/values 目录 下 的 
strings. xml 文件 中 。 

intent-filter 中 声明 了 两 个 子 元 素 action 和 category ,在 这 里 不 详细 讨论 两 个 子 元 素 
的 用 途 , 但 可 以 肯定 的 是 ,intent-filter 的 作用 是 在 使 HelloAndroid 程序 启动 时 ,将 
HelloAndroidActivity 这 个 Activity 作为 默认 的 启动 模块 。 

ADT 包含 了 一 个 可 视 化 的 编辑 器 ,如 图 3. 13 所 示 ,双击 AndroidManifest. xml 文件 
可 直接 进入 可 视 化 编辑 器 。 用 户 可 以 在 不 接触 XML 的 情况 下 ,通过 可 视 化 编辑 器 修改 
Android 工程 的 应 用 程序 名 称 、 包 名 称 、 图 标 、 标 签 和 许可 等 相关 属性 。 

R. java 文件 是 ADT 自动 生成 的 文件 ,包含 对 drawable、layout 和 values 目录 内 的 资 
源 的 引用 指针 ,Android 程序 能 够 直接 通过 R 类 引用 目录 中 的 资源 。R. java 文件 不 能 手 
工 修改 ,所 有 代码 必须 由 ADT 自动 生成 。 如 果 向 资源 目录 中 增加 或 删除 资源 文件 , 则 需 
要 在 工程 名 称 上 布 击 ,选择 Refresh 命令 来 更 新 R. java 文件 中 的 代码 。 

HelloAndroid 工程 生成 的 R.java 文件 的 代码 如 下 。 
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9 Android Manifest 


v Wsnifest General Attributes: 
Defines general information about the Androi dlani fest xal 


[rds hrben HelloAndroid 


四 ] 


To export the application for distribution, you have the following options 


. to export and sin an AE 
Mani fest [Application] Permissions |Tnstrunentation|Androi dlani fest =al | 


A 3.13 HelloAndroid 工程 的 目录 和 文件 


1 
2 

3 public final class R ( 

4 public static final class attr ( 

5 ) 

6 public static final class drawable ( 

7 public static final int icon- 0x7£020000; 
8 

9 


) 
pdblic static final class layout ( 
10 public static final int main- 0x7£030000; 
1 } 
2 public static final class string ( 
13 public static final int app name= 0x7f040001; 
14 public static final int hello- 0x7f040000; 
15 } 
16 } 


R 类 包含 的 几 个 内 部 类 ,分 别 与 资源 类 型 相对 应 ,资源 ID 便 保存 在 这 些 内 部 类 中 ， 
例如 子 类 drawable 表示 图 像 资 源 ,内 部 的 静态 变量 icon 表示 资源 名 称 ,其 资源 ID 为 
0x7{f020000。 一 般 情况 下 ,资源 名 称 与 资源 文件 名 相同 (不 包含 扩展 名 ), 如 icon 对 应 
src/drawable 目录 下 的 icon. png X fF. main 对 应 src/layout 目录 下 的 main. xml 文件 。 

资源 的 引用 一 般 有 两 种 方法 ,一 种 方法 是 在 代码 中 引用 资源 , 另 一 种 方法 则 是 在 资 
源 中 引用 资源 。 

在 代码 中 引用 资源 时 ,需要 在 代码 中 使 用 资源 ID, 可 以 通过 [R. resource. type 
.resource name ]3X # [ andrlid. R. resource. type. resource. name | 获取 资源 ID。 其 中 
resource type 代表 资源 类 型 .也 就 是 R 类 中 的 内 部 类 名 称 ;resource_name 代表 资源 名 
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称 ,对 应 资源 的 文件 名 (不 包含 扩展 名 ) 或 在 XML 文件 中 定义 的 资源 名 称 属性 。 例 如 在 
HelloAndroid. java 中 ,第 11 行 代码 便 是 在 代码 中 对 资源 的 引用 。 

在 资源 中 引用 资源 时 ,一 般 的 引用 格式 为 @[package: jtype:name。 其 中 ,@ 表 示 对 
资源 的 引用 ;package 是 包 名 ,如 果 在 相同 的 包 内 ,package 则 可 省 略 ;type 是 资源 的 类 型 ， 
例如 string 或 drawable;name 是 资源 的 名 称 。 例 如 在 main. xml 文件 中 ,第 10 行 代码 就 
是 在 资源 中 对 资源 的 引用 。 

main. xml 文件 是 界面 布局 文件 ,利用 XML 语言 描述 的 用 户 界面 ,界面 布局 的 相关 
内 容 将 在 第 5 章 用 户 界 面 设 计 中 进行 详细 介绍 。main. xml 代码 的 第 7 行 声明 在 界面 中 
使 用 TextView 控件 , TextView 控件 主要 用 来 显示 字符 串 文本 。 代 码 第 10 行 说 明 
TextView 控件 需要 显示 的 字符 串 , 非 常 明显 , @ string/hello 是 对 资源 的 引用 。 通 过 
strings. xml 文件 的 第 3 行 代 码 分 析 , 在 TextView 控件 中 显示 的 字符 串 应 是 “Hello 
World,HelloAndroidActivity!”。 如 果 读 者 修改 strings. xml 文件 的 第 3 行 代码 的 内 容 ， 
重新 编译 .运行 后 ,模拟 器 中 显示 的 结果 也 应 随 之 更 改 。 
main. xml 文件 的 代码 如 下 。 


1 <?xml version- "1.0" encoding- "utf- 8"?> 
2  «Linearlayout xmins:ardroid- "http: //sdemas.android.oa/ack/ res/android"* 
3 android:orientation- "vertical" 

4 android:layout width= "fill parent" 

5 android:layout beight- "fill parent" 
6 > 

T <TextView 

8 android:layout width= "fill parent" 

9 android:layout beight- "wrap content" 
10 android:text- "8 string/hello" 

1 > 

12  «/Linearlayout^ 


strings. xml 文件 的 代码 如 下 。 


3 <?xml version- "1.0" encoding- "utf- 8"?> 

2 < resources» 

3 < string name= "hello"> Hello World,HelloAndroidActivity!« /string» 
4 < string name- "app name" HelloAndroick /string> 

5 < /resources» 


HelloAndroidActivity. java 是 Android T. f [5] St 48 f Activity 名 称 创建 的 java X 
件 , 这 个 文件 完全 可 以 手工 修改 。 为 了 在 Android 系统 上 显示 图 形 界 面 .需要 使 用 代码 
继承 Activity 类 ,并 在 onCreateO 函数 中 声明 需要 显示 的 内 容 。 

HelloAndroidActivity. java 文件 的 代码 如 下 。 


46 (AST 


1 package edu.hrbeu.Hellohndroid; 

2 

3 import android.app.Activity; 

4 import android.os.Bundle; 

5 

6 public class BellohndroidActivity extends Activity { 

7 /* Called when the activity is first created. * / 
8 @ override 

9 public void onCreate (Bundle savedInstanceState) ( 
10 super .onCreate (savedInstanceState) ; 

n setContentView (R.layout.main) ; 

12 ) 

13 } 


代码 的 第 3 行 和 第 4 行 , 通 过 android. jar 从 Android SDK 中 引入 了 Activity 和 
Bundle 两 个 重要 的 包 , 用 以 子 类 继承 和 信息 传递 ;第 6 行 声 明 HelloAndroidActivity 类 
继承 Activity 类 ;第 8 行 表 明 需 要 重 写 onCreateO PRG; H 9 行 的 onCreate() 在 Activity 
首次 启动 时 会 被 调用 ,为 了 便于 理解 ,可 以 认为 onCreate() 是 HelloAndroid 程序 的 主人 
口 函 数 ;第 10 行 调用 父 类 的 onCreate( ) 函数 ,并 将 savedInstanceState 传递 给 父 类 ， 
savedInstanceState 是 Activity 的 状态 信息 ;第 11 行 声 明了 需要 显示 的 用 户 界面 ,此 界面 
是 用 XML 语言 描述 的 界面 布局 ,保存 在 scr/layout/main. xml 资源 文件 中 。 

本 节 分 析 了 Android 程序 的 目录 结构 和 文件 的 用 途 , 对 AndroidManifest. xml 文件 、 
Java 代码 文件 .资源 引用 和 R. java 等 内 容 有 了 初步 的 了 解 ,下 一 节 将 着 重 介绍 如 何 使 用 
命令 行 工具 创建 Android 程序 ,有 助 于 深入 理解 Android 程序 的 生成 安装 和 运行 过 程 。 
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在 介绍 使 用 命令 行 工 具 开发 Android 程序 前 ,首先 介绍 如 何 通过 命令 行 建立 AVD, 
并 通过 命令 行 启动 Android 模拟 器 。 如 果 读 者 已 经 通过 AVD 管理 器 建立 了 AVD, 且 并 
不 关心 如 何 通过 命令 行 建立 AVD 过 程 ,完全 可 以 跳 过 本 节 。 

建立 AVD 需要 使 用 Windows 系统 的 命令 行 工具 CMD, A "JF li" "is £5" CMD 
中 启动 命令 行 工 具 , 并 进入 二 Android SDK>/tools 目录 下 ,其 中 二 Android SDK X8 
Android SDK 所 在 的 目录 ,笔者 的 Android SDK 的 安装 在 G:\Android\android-sdk- 
windows。 

首先 通过 android list targets 命令 搜索 二 Android SDK — /platforms 和 二 Android 
SDK>/add-ons 目录 下 所 有 有 效 的 Android 系统 ,并 将 Android 系统 映像 列表 显示 出 
来 ,如 图 3. 14 所 示 。 共 有 两 个 可 以 选择 的 编译 目标 ,分 别 是 4. 0 版 本 Android 系统 和 支 
持 Google API 的 4.0 版 本 Android 系统 。 

使 用 android create avd -n android4. 0 -t 1 命令 ,以 id 为 1 的 4.0 版 本 Android 系统 


Bil SA CA Windows system32Vcmd.exe 


GR, QUGA, WQUGA480. UQUGR432, USUGR, VUGRBOB Cdefau 


. HUGA, UQUGR432, WUGASOB < 


3.14 Android 系统 映像 列表 


为 目标 ,建立 一 个 名 为 Android 4.0 的 AVD。 其 中 ,-n 参数 表明 AVD 的 名 称 ,-t 参数 表 
明 选 择 的 Android 系统 的 id 值 。 输 入 AVD 创建 命令 后 ,系统 会 询问 用 户 是 否 需要 定制 
硬件 配置 清单 (Do you wish to create a custom hardware profile) ,这 里 选择 no ,使 用 默认 
的 硬件 配置 了 结果 如 图 3. 15 所 示 。 当 然 也 可 以 选择 yes, 根 据 需 要 重新 定制 模拟 器 
支持 的 硬件 清单 。 


ingle ABI a 


dk-vindovs stool 


3.15 建立 AVD 


建立 AVD 过 程 中 , Android 工具 会 在 文件 系统 中 建立 Android4. 0. ini 文件 和 
Android4. 0. avd 目录 。 其 中 ,Android4. O. ini 文件 标识 出 模拟 器 的 版 本 和 模拟 器 所 在 的 目 
录 ;Android4. 0. avd 目录 则 是 模拟 器 的 工作 目录 ,用 以 保存 AVD 配置 文件 .用 户 数据 文件 、 
SD 卡 映像 和 模拟 器 运行 过 程 中 可 能 产生 的 文件 。Android4. 0. ini 文件 和 Android4. 0. avd 
目录 的 保存 位 置 ,会 根据 用 户 使 用 的 操作 系统 不 同 而 不 同 , 如 果 用 户 使 用 的 是 Windows XP 
系统 , 则 目录 会 保存 在 C:\Documents and SettingsV— user. android\ 下 ;如 果 用 户 使 用 的 
是 Windows 7 系统 , 则 会 保存 在 C: NUsersV— user. android。AVD 的 管理 命令 和 虚拟 硬 
件 列表 可 以 参考 附录 A。 

Android 模拟 器 不 能 通过 直接 双击 二 Android SDK— /tools 目录 下 的 emulator. exe 
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启动 ,必须 在 启动 模拟 器 时 指定 所 使 用 的 AVD。 使 用 android list avds 命令 查询 已 经 建 
立 的 AVD, 查 询 结果 如 图 3. 16 Bros. 


E EA: CAWindows|system32Vcmd.exe. 


4 4.8 CAPI 
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3: Indo id sandro id-sdk-window: 


图 3.16 已 有 的 AVD 列表 


笔者 系统 中 有 两 个 AVD ,两 个 都 是 4. 0 版 本 的 Android 系统 ,其 中 Android4. 0 是 刚 
刚 通 过 命令 行 建立 的 AVD。 在 CMD 中 输入 命令 emulator -avd Android4. 0, 随 即 可 以 
见 到 Android 模拟 器 的 启动 界面 。 


34 命令 行 创建 程序 


通过 前 面 章 节 的 学 习 , 读 者 已 可 以 使 用 Eclipse 建立 Android 应 用 程序 ,Eclipse 能 够 
为 使 用 者 提供 良好 的 编辑 和 调试 环境 ,并 能 够 自动 完成 程序 的 编译 apk 打包 和 上 传 安装 
等 过 程 。 但 Eclipse 并 不 是 唯一 的 Android 程序 开发 环境 ,Intellij IDEA 和 文本 编辑 器 
同样 也 能 够 完成 Android 程序 开发 。Android SDK 中 包含 了 Android 程序 开发 过 程 中 
所 需要 的 编译 .调试 .打包 和 上 传 工 具 , 能 够 在 非 Eclipse 环境 下 帮助 开发 者 完成 Android 
程序 的 开发 工作 。 本 节 将 尝试 使 用 文本 编辑 器 和 命令 行 工具 创建 Android 程序 
HelloCommandline, 如 果 读 者 对 使 用 命令 行 工 具 开 发 Android 程序 并 不 感 兴趣 ,完全 可 
以 跳 过 本 节 。 

Android 命令 行 工 具 存 放 在 二 Android SDK 二 /tools 和 二 Android SDK 二 /platform- 
tools 目录 中 ,这些 命令 行 工具 非常 重要 ,即使 用 户 使 用 Eclipse 开发 Android 程序 ,很 多 
重要 的 功能 也 都 是 调用 这 些 命令 行 工具 完成 的 。 

下 面 的 内 容 将 介绍 如 何 使 用 命令 行 工具 开发 Android 程序 ,一 般 分 为 三 个 步 又: 

(1) 使 用 android. bat 建立 HelloCommandline 工程 所 需 的 目录 和 文件 ; 

(2) 使 用 Apache Ant 对 HelloCommandline 工程 进行 编译 和 apk 打包 ; 

(3) 使 用 adb. exe 将 HelloCommandline 工程 上 传 到 Android 模拟 器 中 。 


1. 建立 工程 所 需 目 录 和 文件 


首先 ,使 用 android. bat 建立 HelloCommandline 工程 所 需 的 目录 和 文件 。android 
.bat 是 一 个 批 处 理 文件 ,可 以 用 来 建立 和 更 新 Android 工程 ,同时 也 可 以 管理 AVD, 
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android. bat 能 够 创建 Android 工程 所 需要 的 目录 结构 和 文件 , 表 3. 2 给 出 了 android. 
bat 建立 和 更 新 Android 工程 的 命令 和 参数 说 明 。 


表 3.2 Android 工程 管理 命令 


*$ e $ HU 说 明 & 注 
-k — package 包 名 称 必 备 参数 
-n <name> 工程 名 称 
android create project -a activity Activity 名 称 
-t target 新 工程 的 编译 目标 必 备 参数 
-p <path> 新 工程 的 保存 路 径 必 备 参数 
-t <targe> 设 定 工程 的 编译 目标 必 备 参数 
android update project -p path 工程 的 保存 路 径 必 备 参数 
-n <name> 工程 名 称 


使 用 android. bat 建立 Android 工程 ,需要 用 “开始 ”一 “运行 "一 CMD 命令 启动 
CMD, 并 进入 二 Android SDK>/tools 目录 ,首先 通过 android list targets 命令 搜索 有 效 
的 Android 系统 ,搜索 结果 如 图 3. 14 所 示 。 

然后 输入 如 下 命令 建立 工程 目录 和 基本 文件 ,选择 ID 为 1 的 Android 4.0 作为 目标 
系统 。 


android create project - n HelloCammandline - k edu.hrbbeu.HelloCammandline - a HelloCammandline - t 
1 - p g:VandroidWworkplaceWHelloCammandline 


新 工程 名 称 为 HelloCommandline, 包 名 为 edu. hrbeu. HelloCommandline, Activity 
名 称 是 HelloCommandline. 编译 目标 的 ID 为 1, 新 工程 的 保存 路 径 是 g:\Android\ 
workplace\ HelloCommandline。 另 一 种 命令 输入 方法 如 下 。 


android create project - - name HelloCammandline - - package edu.hrbeu.HelloCamandline - - activity 
HelloCammandline - - target 1 - - path g:\Android\workplace\HelloCommandl ine 


输入 后 的 运行 结果 如 图 3.17 所 示 ,建立 了 用 于 HelloCommandline 工程 的 目录 和 文 
件 。 使 用 命令 行 工具 创建 的 Android 工程 可 以 移动 到 其 他 目录 中 ,因为 android. bat 在 
工程 创建 过 程 中 ,在 local. properties 中 保存 了 Android SDK 的 路 径 , 因 此 工程 建立 后 ， 
建议 不 要 改变 Android SDK 的 保存 路 径 。 

仔细 观察 android. bat 建立 的 目录 和 文件 ,发 现 其 中 一 些 在 Eclipse 开发 环境 中 从 未 
出 现 过 的 目录 和 文件 ,例如 build. xml、ant. properties 和 local. properties 目录 。 这 些 新 
目录 和 文件 的 出 现 ,主要 是 为 了 在 构建 Android 程序 时 使 用 自动 化 工具 Apache Ant。 
Apache Ant 是 一 个 将 软件 编译 .测试 .部 署 等 步骤 联系 在 一 起 的 自动 化 工具 ,多 用 于 
Java 环境 中 的 软件 开发 。 在 Android 程序 构建 中 使 用 Apache Ant, 可 以 简化 程序 的 编译 
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Windows system32Vcmd.exe. 


图 3.17 android 命令 的 运行 结果 
和 apk 打包 过 程 。 为 了 使 Apache Ant 可 以 正常 使 用 ,用 户 需 要 在 Windows 系统 中 添加 
- 些 新 的 环境 变量 ,新 增 的 环境 变量 如 表 3. 3 所 示 。 
表 3.3 新 增 的 系统 环境 变量 


变 量 名 变 量 值 备 注 
JAVA_HOME |C:\Program Files\Java\jdk1. 7. 0 新 增 变量 
ANT_HOME E:\Android\apache-ant-1. 8. 2 新 增 变量 
ANDROID HOME | E; VAndroidVandroid-sdk-windows 新 增 变量 

$ JAVA_HOME\jre/lib; $ JAVA_ HOME\lib; $JAVA_HOME/ : 
CLASSPATH STAVA- Nre S JAVA: Mibi STAVA- 新 增 变量 
lib/tools. jar 
ud ;% ANT_HOME%\ bins%JAVA_ HOME% \ bin: % ANDROID. | a 475 
= HOME? tools; % ANDROID_HOME%\ platform-tools; Jem 


其 中 ,JAVA_HOME 是 JDK 的 安装 目录 ,根据 JDK 实际 安装 位 置 进行 修改 ;ANT _ 
HOME 是 Apache Ant 的 安装 目录 ,根据 Apache Ant 实际 安装 位 置 进行 修改 ; 
ANDROID HOME Æ Android SDK 的 安装 目录 ,根据 实际 安装 位 置 进 行 修 改 ; 
CLASSPATH 是 需要 使 用 库 文 件 的 位 置 ; Path 是 可 执行 文件 的 搜索 路 径 , 将 二 Apache 
Ant 二 /bin、 —JDK- /bin M< Android SDK 二 /tools 三 个 目录 追加 到 原 有 的 Path 变量 
值 中 ,目录 之 间 使 用 分 号 分 隔 。 


2. 编译 与 打包 


环境 变量 设置 完毕 后 ,可 以 在 CMD 中 运行 输入 ant 命令 ,通过 命令 的 输出 判断 环境 
变量 是 否 正确 设置 。 如 果 输 出 的 提示 包含 “Unable to locate tools. jar. Expected to find 
it in…”, 则 表明 没有 正确 设置 环境 变量 。 如 果 环 境 变量 设置 正确 ,ant 命令 的 输出 结果 应 
为 “Buildfile: build. xml does not exist1”, 如 图 3. 18 所 示 。 

Apache Ant 已 经 可 以 正常 运行 了 ,但 在 构建 Android 程序 前 ,首先 介绍 一 下 
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C: Wsers\Adninistrator> 


图 3.18 ant 命令 的 输出 结果 


Android 程序 的 数字 签名 机 制 。 在 Android 平台 上 开发 的 所 有 应 用 程序 ,在 安装 到 模拟 
器 或 手机 前 都 必须 进行 数字 签名 。 如 果 强 行将 没有 数字 签名 的 Android 程序 安装 到 模 
拟 器 中 , 将 返回 错误 提示 “Failure [INSTALL _ PARSE | FAILED _ NO _ 
CERTIFICATERS]”。 

在 Eclipse 开发 环境 中 ,在 将 Android 程序 安装 到 模拟 器 之 前 ,ADT 会 利用 内 置 的 
debug key 为 apk 文件 自动 进行 数字 签名 ,这 使 用 户 无 须 自己 产生 数字 签名 的 私 钥 ,而 能 够 
利于 debug key 快速 完成 程序 调试 。 但 有 一 上 : 意 , 如 果 用 户 希 望 正 式 发 布 自己 的 应 
用 程序 , 则 不 能 使 用 debug key, 而 必须 使 用 私有 密 钥 对 Android 程序 进行 数字 签名 。 

Apache Ant 构建 Android 应 用 程序 时 ,支持 Debug 和 Release 两 种 构建 模式 。 
Debug 模式 是 供 调试 使 用 的 构建 模式 ,用 于 快速 测试 所 开发 的 应 用 程序 ,Debug 模式 自 
动 使 用 debug key 完成 数字 签名 。Release 模式 是 正式 发 布 应 用 程序 时 使 用 的 构建 模式 ， 
生成 没有 数字 签名 的 apk 文件 。 

这 里 使 用 Apache Ant 的 Debug 模式 对 HelloCommandline 工程 进行 编译 ,生成 具 
有 debug key 签名 的 apk 打包 文件 。 打 开 CMD, 在 工程 的 根 目录 下 ,输入 ant debug. 显 
示 结 果 如 图 3. 19 所 示 。 


PIN 
ux 


图 3.19 ant debug 的 输出 结果 


命令 运行 后 , Apache Ant 在 bin 目录 中 生成 打包 文件 HelloCommandline-debug 


.apk 和 HelloCommandline-debug-unaligned. apk, 其 中 HelloCommandline-debug. apk 
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是 使 用 debug key 进行 过 数字 签名 的 打包 文件 .HelloCommandline-debug-unaligned. apk 
是 未 经 过 签名 的 打包 文件 。 如 果 需 要 使 用 Release 模式 , 则 必须 在 CMD 中 输入 ant 
release, 运 行 后 会 在 bin 目录 中 生成 打包 文件 HelloCommandline-unsigned. apk. 

apk 文件 是 Android 系统 的 安装 程序 ,上 传 到 Android 模拟 器 或 Android 手机 后 可 
以 进行 安装 。apk 文件 本 身 是 一 个 zip 压缩 文件 ,能 够 使 用 WinRAR, UnZip 等 软件 直接 
打开 ,图 3. 20 所 示 的 是 用 WinRAR 打开 的 HelloCommandline-debug. apk 文件 。 


n 
SB HelloCommendline-debug.apk - WinRAR [EIE 


pun $e P SERO SAN MO) 
jun 解压 到 mu ze | nsa Em asi 
国 HelloCommandline-debug.apk - ZIP ERS, 解 包 大 小 为 6.023 字 节 ~ 
am | 大 小 c šE O BBI CRC32 
META-INF Folder 
res Folder 
国 AndroidManifestxml 1,320 523 XML Document 2011/10/20 2.. D6F11E91 
[à classes.dex 1,744 848 文件 dex 2011/10/20 502E4F20 
[a resources.arsc 772 772 文件 arsc 2011/10/202.. 7CE99D.. 
£30 总 计 2 xix $03,836 FT 个 文件 ) 


图 3.20 HelloCommandline-debug. apk 文件 


其 中 ,res 目录 用 来 存放 资源 文件 ;AndroidManifest. xml 是 Android 程序 的 声明 文件 ; 
classes. dex 是 Dalvik 虚拟 机 的 可 执行 程序 ;resources. arsc 是 编译 后 的 二 进 制 资源 文件 。 

3. 上 传 工程 到 模拟 器 

使 用 adb. exe 可 将 HelloCommandline 程序 上 传 到 Android 模拟 器 中 。 

Android 模拟 器 正常 启动 后 ,利用 adb. exe 工具 将 HelloCommandline-debug. apk 文 
件 上 传 到 模拟 器 中 ,adb. exe 工具 的 命令 和 参数 可 以 参考 附录 C。 这 个 工具 除了 能 够 在 
Android 模拟 器 中 上 传 和 下 载 文件 ,还 能 够 管理 模拟 器 状态 ,是 调试 程序 时 不 可 缺少 的 工 
具 之 一 。 在 CMD 中 ,进入 二 HelloCommandline 二 /bin 目录 ,输入 命令 adb install 
HelloCommandline-debug. apk, 完 成 apk 程序 上 传 到 模拟 器 的 过 程 。 如 果 上 传 成 功 ,将 
显示 图 3.21 所 示 的 结果 。 


B SA: C\Windows\system3Z\cmd exe. [EI] 


3.21 向 模拟 器 中 上 传 apk 文件 


apk 文件 上 传 后 ,并 不 会 在 Android 模拟 器 上 直接 运 
行 , 需 要 用 户 手 工 启 动 HelloCommandline 程序 。 在 
图 3. 22 的 左下 方 , 能 找到 刚刚 安装 的 HelloCommandline 
程序 , 单 击 图 标 即 可 启动 应 用 程序 。 如 果 在 模拟 器 中 找 不 
到 HelloCommandline 程序 ,尝试 重新 启动 Android 模拟 

5. KX Android 的 包 管 理 器 (Package Manager) 有 时 仅 
在 模拟 器 启动 的 时 候 检 查 应 用 程序 的 AndroidManifest 
. xml 文件 ,这 就 导致 部 分 上 传 的 Android 应 用 程序 不 能 
立即 启动 。 

用 户 在 修改 HelloCommandline 工程 代码 后 ,需要 使 
用 Apache Ant 重新 编译 和 打包 应 用 程序 ,并 将 新 生成 的 a 
apk 文件 上 传 到 Android 模拟 器 中 。 但 在 使 用 ADB 工具 图 3.22 模拟 器 中 的 应 用 程序 
Cadb. exe) 向 模拟 器 上 传 apk 文件 时 ,会 出 现 错误 提示 
“Failure [INSTALL_FAILED_ALREADY_EXISTS]”, 如 图 3. 23 所 示 。 


HelloAndroid Halocomma Messaging Music 


dows\system32\cmd.exe = | © mb 


e\HelloConnandline \hin>Yadb install HelloConmandline-d 


andline-debug.apk 


图 3.23 安装 文件 已 存在 的 错误 提示 


出 现 错误 提示 的 原因 是 模拟 器 中 已 存在 该 文件 ,用 户 需要 在 模拟 器 中 先 删 除 原 有 
apk 文件 ,再 使 用 ADB 工具 上 传 新 的 apk 文件 。 删 除 已 经 安装 在 Android 系统 中 的 apk 
文件 可 使 用 “adb uninstall 二 包 名 称 二 ”的 方法 ,例如 删除 HelloCommandline 工程 的 apk 
文件 . 则 可 在 CMD 中 输入 命令 adb uninstall edu. hrbeu. HelloCommandline, 提示 
Success 则 表示 成 功 删除 ,如 图 3. 24 所 示 


Bj 管理 员 : CAWindows\system32\cmd.exe cie 


G: Android\workplace HelloConnandline \binYadb uninstall edu.hrbeu.HelloCommandli| 


G: android workplace He lloConmandline Nbin?, 


图 3.24 删除 已 安装 程序 
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Z ER 


1. 简 述 R. java 和 AndroidManifest. xml 文件 的 用 途 。 

2. 尝试 建立 一 个 支持 Google APIs 的 AVD. 

3. 使 用 Eclipse 建立 名 为 MyAndroid 的 工程 , 包 名 称 为 edu. hrbeu. MyAndroid, 使 
用 第 2 题 中 建立 的 AVD, 程 序 运行 时 显示 Hello MyAndroid。 

4. 尝试 使 用 命令 行 方 式 建立 一 个 Android 应 用 程序 ,并 完成 apk 打包 和 程序 安装 
过 程 。 
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Android 生命 周期 


Android 生命 周期 是 从 程序 启动 到 程序 终止 的 全 过 程 。 通 过 本 章 的 学 习 可 以 让 读者 
深入 理解 Android 系统 管理 生命 周期 的 必要 性 ,并 以 Activity 为 例 说 明 Android 系统 如 
何 管理 程序 组 件 的 生命 周期 。 对 调试 方法 和 工具 的 介绍 ,有 助 于 程序 开发 人 员 快 速 找到 
程序 中 的 错误 ,而 且 可 以 对 特殊 的 事件 回调 函数 进行 调试 。 

本 章 学 习 目 标 : 

。 了 解 Android 系统 的 进程 优先 级 的 变化 方式 ; 

* 了 解 Android 系统 的 四 大 基本 组 件 ; 

* 了 解 Activity 生命 周期 中 各 状态 的 变化 关系 ; 

。 掌握 Activity 事件 回调 函数 的 作用 和 调用 顺序 ; 

。 掌握 Android 应 用 程序 的 调试 方法 和 工具 。 


41 程序 生命 周期 


软件 生命 周期 是 软件 从 产生 到 废弃 所 历经 的 几 个 阶段 ,一 般 包括 可 行 性 分 析 、 开 发 
计划 、 需 求 分 析 与 设计 ,编码 ,测试 和 维护 等 过 程 。Android 的 程序 生命 周期 与 软件 生命 
周期 的 定义 不 同 , 指 的 是 在 Android 系统 中 进程 从 启动 到 终止 的 所 有 阶段 ,也 就 是 
Android 程序 从 启动 到 停止 的 全 过 程 。 

Android 系统 一 般 是 运行 在 资源 受 限 的 硬件 平台 上 , 因 


此 资源 管理 对 Android 系统 至 关 重 要 。Android 系统 主动 高 优先 级 前 台 进程 

管理 资源 ,为 了 保证 高 优先 级 程序 正常 运行 ,可 以 在 无 任何 

警告 的 情况 下 终止 低 优先 级 程序 ,并 回收 其 使 用 的 系统 资 MIS: 

源 。 因 此 ,Android 程序 并 不 能 完全 控制 自身 的 生命 周期 ， 

而 是 由 Android 系统 进行 调度 和 控制 的 。 
Android 系统 尽 可 能 地 不 主动 去 终止 应 用 程序 ,即使 生 i 

命 周期 结束 的 程序 也 会 保存 在 内 存 中 ,以 便 再 次 快速 启动 。 (gp 后 台 进 程 

但 在 内 存 紧张 时 ,系统 会 根据 进程 的 优先 级 清除 进程 ,回收 mE 

系统 资源 。Android 系统 中 的 进程 优先 级 如 图 4. 1 所 示 , 优 


先 级 从 高 到 低 分 别 为 前 台 进 程 、 可 见 进程 .服务 进程 .后 台 进 图 4.1 进程 优先 级 
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程 和 空 进 程 。 
1. 前 台 进程 


前 台 进 程 是 Android 系统 中 最 重要 的 进程 ,是 与 用 户 正在 交互 的 进程 ,包含 4 种 
情况 : 

。 进程 中 的 Activity 正在 与 用 户 进行 交互 ; 

。 进程 服务 被 Activity 调用 ,而 且 这 个 Activity 正在 与 用 户 进行 交互 ; 

。 进程 服务 正在 执行 生命 周期 中 的 回调 函数 , 如 onCreate ()、onStart ( ) 或 

onDestroy O ; 

。 进程 的 BroadcastReceiver 正在 执行 onReceive() 函 数 。 

Android 系统 在 多 个 前 台 进程 同时 运行 时 ,可 能 会 出 现 资源 不 足 的 情况 ,此 时 也 会 清 
除 部 分 前 台 进 程 ,保证 主要 的 用 户 界面 能 够 及 时 响应 。 


2. 可 见 进程 


可 见 进程 指 部 分 程序 界面 能 够 被 用 户 看 见 , 却 不 在 前 台 与 用 户 交互 ,不 响应 界面 事 
件 的 进程 。 例 如 ,新 启动 的 Android 程序 将 原 有 程序 部 分 遮挡 , 原 有 程序 从 前 台 进 程 变 
为 可 见 进程 。 另 外 ,如 果 一 个 进程 包含 服务 , 且 这 个 服务 正在 被 用 户 可 见 的 Activity 调 
用 ,此 进程 同样 被 视 为 可 见 进程 。 一 般 Android 系统 会 存在 少量 的 可 见 进程 ,只 有 在 极 
端的 情况 下 ,Android 系统 才 会 为 保证 前 台 进 程 的 资源 而 清除 可 见 进程 。 


3. 服务 进程 


一 个 包含 已 启动 服务 的 进程 就 是 服务 进程 。 服 务 没有 用 户 界面 ,不 与 用 户 直 接 交 
互 , 但 能 够 在 后 台 长 期 运行 ,提供 用 户 所 关心 的 重要 功能 ,例如 播放 MP3 文件 或 从 网 络 
下 载 数 据 。 因 此 ,Android 系统 除非 不 能 保证 前 台 进程 或 可 见 进程 所 必要 的 资源 ,否则 不 
会 强行 清除 服务 进程 。 


4. 后 台 进程 


如 果 一 个 进程 不 包含 任何 已 经 启动 的 服务 ,而 且 没 有 任何 用 户 可 见 的 Activity, 则 这 
个 进程 就 是 后 台 进 程 。 例 如 一 个 仅 有 Activity 组 件 的 进程 , 当 用 户 启动 了 其 他 应 用 程序 
使 这 个 进程 的 Activity 完全 被 遮挡 , 则 这 个 进程 便 成 为 了 后 台 进程 。 一 般 情况 下 ， 
Android 系统 中 存在 数量 较 多 的 后 台 进 程 ,在 系统 资源 紧张 时 ,系统 将 优先 清除 用 户 较 长 
时 间 没 有 见 到 的 后 台 进 程 。 


5. 空 进程 


空 进 程 是 不 包含 任何 活跃 组 件 的 进程 ,例如 一 个 仅 有 Activity 组 件 的 进程 , 当 用 户 
关闭 Activity 后 ,这 个 进程 就 成 为 空 进程 。 空 进程 在 系统 资源 紧张 时 会 被 首先 清除 ,但 
为 了 提高 Android 系统 应 用 程序 的 启动 速度 ,Android 系统 会 将 空 进程 保存 在 系统 内 备 
用 ,在 用 户 重新 启动 该 程序 时 , 空 进程 会 被 重新 使 用 。 
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在 Android 中 ,进程 的 优先 级 取决 于 所 有 组 件 中 的 优先 级 最 高 的 部 分 。 例 如 ,在 进 
程 中 同时 包含 部 分 可 见 的 Activity 和 已 经 启动 的 服务 , 则 该 进程 是 可 见 进程 ,而 不 是 服 
务 进程 。 另 外 ,进程 的 优先 级 会 根据 与 其 他 进程 的 依赖 关系 而 变化 。 例 如 ,进程 A 的 服 
务 被 进程 B 调用 ,如 果 调 用 前 进程 A 是 服务 进程 ,进程 B 是 前 台 进 程 , 则 调用 后 进程 A 
也 具有 前 台 进 程 的 优先 级 。 


42 Anad 组 件 


Android 应 用 程序 由 组 件 组 成 ,组 件 是 可 以 被 调用 的 基本 功能 模块 。Android 系统 
利用 组 件 实现 程序 内 部 或 程序 间 的 模块 调用 ,以 解决 代码 复 用 的 问题 ,这 是 Android 系 
统 非 常 重要 的 特性 。 在 程序 设计 时 ,在 AndroidManifest. xml 中 声明 可 共享 的 组 件 , 声 明 
后 其 他 应 用 程序 可 以 直接 调用 这 些 共 享 组 件 。 例 如 ,程序 A 实现 了 文件 压缩 的 功能 ,并 
对 外 共享 了 这 个 组 件 ,程序 B 则 不 必 再 开发 文件 压缩 功能 ,而 直接 调用 程序 A 的 共享 组 
件 即 可 。 

但 这 种 特性 存在 这 样 一 个 问题 ,如 果 共 享 组 件 所 在 的 进程 没有 启动 ,这 个 共享 组 件 
如 何 被 其 他 程序 调用 。 为 了 解决 这 一 问题 ,Android 系统 必须 能 够 在 其 他 程序 调用 共享 
组 件 时 ,直接 启动 被 调用 的 共享 组 件 。 因 此 ,Android 系统 没有 使 用 常见 的 应 用 程序 人 口 
点 (类 似 于 Java 程序 的 Main 函数 ) 的 方法 ,而 是 允许 共享 组 件 被 Android 系统 直接 实例 
化 ,从 而 保证 能 够 调用 进程 没有 启动 的 共享 组 件 。 

Android 系统 有 4 个 重要 的 组 件 ,分 别 是 Activity, Service, BroadcastReceiver 和 
ContentProvider, 

Activity 是 Android 程序 的 呈现 层 , 显 示 可 视 化 的 用 户 界 面 , 并 接收 与 用 户 交互 所 产 
生 的 界面 事件 ,与 “ 窗 体 "的 概念 非常 相似 。Android 应 用 程序 可 以 包含 一 个 或 多 个 
Activity ,一般 在 程序 启动 后 会 呈现 一 个 Activity, 用 于 提示 用 户 程序 已 经 正常 启动 。 
Activity 在 界面 上 的 表现 形式 一 般 是 全 屏 窗 体 , 也 可 以 是 非 全 屏 悬 浮 窗 体 或 对 话 框 。 

Service 一 般 用 于 没有 用 户 界 面 , 但 需要 长 时 间 在 后 台 运 行 的 应 用 。 例 如 ,在 播放 
MP3 音乐 时 ,使 用 Service 播放 MP3 音乐 ,可 以 在 关闭 播放 器 界面 的 情况 下 长 时 间 播 放 
MP3 音乐 ,并 通过 对 外 公开 Service 的 通信 接口 ,控制 MP3 音乐 播放 的 启动 .暂停 和 
停止 。 

BroadcastReceiver 是 用 来 接受 并 响应 广播 消息 的 组 件 。 大 部 分 广播 消息 是 由 系统 
产生 的 ,例如 时 区 改变 .电池 电量 低 或 语言 选项 改变 等 ,但 应 用 程序 也 可 以 产生 广播 消 
息 ,例如 数据 下 载 完 毕 等 。BroadcastReceiver 不 包含 任何 用 户 界面 ,但 可 以 通过 启动 
Activity 或 者 Notification 通知 用 户 接 收 到 重要 信息 。Notification 能 够 通过 多 种 方法 提 
示 用 户 ,包括 闪 动 背景 灯 、 震 动 设备 .发 出 声音 或 在 状态 栏 上 放置 一 个 持久 的 图 标 等 。 

ContentProvider 是 Android 系统 提供 的 一 种 标准 的 数据 共享 机 制 ,应 用 程序 可 以 通 
过 ContentProvider 访问 其 他 应 用 程序 的 私有 数据 。 私 有 数据 可 以 是 存储 在 文件 系统 中 
的 文件 ,也 可 以 是 SQLite 数据 库 中 的 数据 。Android 系统 内 部 也 提供 一 些 内 置 的 
ContentProvider ,能 够 为 应 用 程序 提供 重要 的 数据 信息 ,例如 联系 人 信息 和 通话 记录 等 。 
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Android 系统 通过 组 件 机 制 , 有 效 地 降低 了 应 用 程序 的 耦合 性 ,使 向 其 他 应 用 程序 共 
享 私有 数据 (ContentProvider) 和 调用 其 他 程序 的 私有 模块 (Service) 成 为 可 能 。 

所 有 Android 组 件 都 具有 自己 的 生命 周期 . 称 为 组 件 生命 周期 ,是 从 组 件 建立 到 组 
件 销毁 的 整个 过 程 。 在 这 个 过 程 中 .组件 会 在 可 见 、 不 可 见 、 活 动 、 非 活动 等 状态 中 不 断 
变化 ,下 一 节 将 主要 对 Activity 的 生命 周期 进行 详细 介绍 。 


43 ”Acivity 生命 周期 


Activity 生命 周期 指 Activity 从 启动 到 销毁 的 过 程 ,在 这 个 过 程 中 ,Activity 一 般 表 
现 为 4 种 状态 ,分 别 是 活动 状态 、 暂 停 状 态 、 停 止 状态 和 非 活动 状态 。(1) 活 动 状态 , 当 
Activity 在 用 户 界面 中 处 于 最 上 层 ,完全 能 被 用 户 看 到 ,能 够 与 用 户 进 行 交互 , 则 
Activity 处 于 活动 状态 。(2) 暂 停 状态 , 当 Activity 在 界面 上 被 部 分 迹 挡 ,该 Activity 不 
再 处 于 用 户 界面 的 最 上 层 , 且 不 能 够 与 用 户 进行 交互 , 则 Activity 处 于 暂停 状态 。(3) 停 
止 状态 , 当 Activity 在 界面 上 完全 不 能 被 用 户 看 到 ,也 就 是 说 这 个 Activity 被 其 他 
Activity 全 部 遮挡 , 则 这 个 Activity 处 于 停止 状态 。(4) 非 活动 状态 ,活动 状态 、 暂 停 状态 
和 停止 状态 是 Activity 的 主要 状态 ,不 在 以 上 三 种 状态 下 的 Activity 则 处 于 非 活动 状态 。 

Activity 4 种 状态 的 变换 关系 如 图 4. 2 所 示 。Activity 启动 后 处 于 活动 状态 ,此 时 的 
Activity 位 于 界面 的 最 上 层 ,是 与 用 户 正 在 进行 交互 的 组 件 , 因 此 Android 系统 会 努力 保 
证 活动 状态 Activity 的 资源 需求 ,资源 紧张 时 可 终止 其 他 状态 的 Activity; 如 果 用 户 启动 
了 新 的 Activity, 部 分 遮挡 了 当前 的 Activity, 或 新 的 Activity 是 半 透 明 的 , 则 当前 的 
Activity 转换 为 暂停 状态 ,Android 系统 仅 在 为 处 于 活动 状态 的 Activity 释放 资源 时 才 
终止 处 于 暂停 状态 的 Activity; 如 果 用 户 启动 新 的 Activity 完全 遮挡 了 当前 的 Activity. 
则 当前 的 Activity 转变 为 停止 状态 ,停止 状态 的 Activity 将 优先 被 终止 ;活动 状态 的 
Activity 被 用 户 关 闭 后 ,以 及 暂停 状态 或 停止 状态 的 Activity 被 系统 终止 后 ,Activity 便 
进入 了 非 活动 状态 。 


图 4.2 Activity 状态 变换 图 


为 能 够 更 好 地 理解 Activity 的 生命 周期 ,还 需要 对 Activity 栈 做 一 下 简要 介绍 。 
Activity 栈 保 存 了 已 经 启动 且 没 有 终止 的 所 有 Activity, 并 遵循 “后 进 先 出 ?的 规则 。 如 
图 4. 3 所 示 «E DUI] Activity 处 于 活动 状态 , 除 栈 顶 以 外 的 其 他 Activity 处 于 暂停 状态 或 
停止 状态 ,而 被 终止 的 Activity 或 已 经 出 栈 的 Activity 则 不 在 栈 内 。 

Activity 的 状态 与 其 在 Activity 栈 的 位 置 有 着 密切 的 关系 ,不 仅 如 此 ,Android 系统 
在 资源 不 足 时 ,也 是 通过 Activity 栈 来 选择 哪些 Activity 是 可 以 被 终止 的 。 一 般 来 讲 ， 
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Activity 
lje : 
活动 状态 {| Activity LAUR Sp Aeiy ”| 非 活动 状态 
Activity 
Activity 
暂停 状态 
或 停止 状态 


[av H Activity — | 非 活动 状态 
Activity 栈 释放 资源 


4.3 Activity 栈 


Android 系统 会 优先 选择 终止 处 于 停止 状态 , 且 位 置 靠 近 栈 底 的 Activity, 因为 这 些 
Activity 被 用 户 再 次 调用 的 机 会 最 小 , 且 在 界面 上 用 户 是 看 不 到 的 。 

随 着 用 户 在 界面 进行 的 操作 ,以 及 Android 系统 对 资源 的 动态 管理 , Activity 不 断 变 
化 其 在 Activity 栈 的 位 置 ,状态 也 不 断 在 4 种 状态 中 转变 。 随 着 Activity 自身 状态 的 变 
化 ,Android 系统 会 调用 不 同 的 事件 回调 函数 ,开发 人 员 在 事件 回调 函数 中 添加 代码 ,就 
可 以 在 Activity 状态 变化 时 完成 适当 的 工作 。 

下 面 的 代码 给 出 了 Activity 的 主要 事件 回调 函数 。 


1  püblic class My&ctivity extends Activity ( 

2 protected void onCreate (Bundle savedInstanceState); 
3 protected void onStart () ; 

4 protected void onRestart () ; 

5 protected void onResume() ; 

6 protected void onPause () ; 

y protected void onStop() ; 

8 protected void onDestroy() ; 

9 ) 


这 些 事件 回调 函数 何 时 被 调用 ,具体 用 途 是 什么 ,以 及 是 否 可 以 被 Android 系统 终 
止 ,可 以 参考 表 4.1。 

除了 Activity 生命 周期 的 事件 回调 函数 以 外 ,还 有 onRestoreInstanceState() 和 
onSaveInstanceState() 两 个 函数 经 常会 被 使 用 ,用 于 保存 和 恢复 Activity 的 界面 临时 信 
息 ,如 用 户 在 界面 中 输入 的 数据 或 选择 的 内 容 等 ,而 onPause() 一 般 被 用 来 保存 界面 的 持 
久 信 息 。 

这 两 个 函数 不 属于 生命 周期 的 事件 回调 函数 ,onSaveInstanceState() 在 Activity 被 
暂时 停止 时 (被 其 他 程序 中 断 或 锁 屏 ) 被 调用 ,而 Activity 在 完全 关闭 时 (调用 finish O PR 
数 ) 则 不 会 被 调用 。 当 暂停 的 Activity 被 恢复 时 ,系统 会 调用 onRestoreInstanceState() 
函数 。 
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表 4.1 Activity 生命 周期 的 事件 回调 函数 


Go 数 | 是 否 可 终止 说 明 
te 否 Activity 启动 后 第 一 个 被 调用 的 函数 ,常用 来 进行 Activity 的 初始 化 ， 
例如 创建 View、 绑 定数 据 或 恢复 信息 等 
onStart() E 当 Activity 显示 在 屏幕 上 时 ,该 函数 被 调用 
onRestart() f 当 Activity 从 停止 状态 进入 活动 状态 前 ,调用 该 函数 
ee s 当 Activity 可 以 接受 用 户 输入 时 ,该 函数 被 调用 。 此 时 的 Activity 位 
onResume 于 Activity 栈 的 栈 顶 
当 Activity 进入 暂停 状态 时 ,该 函数 被 调用 。 主 要 用 来 保存 持久 数据 、 
onPause() E 关闭 动画 、 释 放 CPU 资源 等 。 该 函数 中 的 代码 必须 简短 ,因为 男 一 个 
Activity 必须 等 待 该 函数 执行 完毕 后 才能 显示 在 界面 上 
onStopO 是 当 Activity 不 对 用 户 可 见 后 ,该 函数 被 调用 ,Activity 进入 停止 状态 
在 Activity 被 终止 前 , 即 进入 非 活动 状态 前 ,该 函数 被 调用 。 有 两 种 情 
onDestroy() 是 况 该 函数 会 被 调用 :(1) 当 程 序 主动 调用 finish O 函数 ; (2) 程 序 被 
Android 系统 终结 


举 个 例子 说 明 这 两 个 函数 是 如 何 被 调用 的 。 如 用 户 启动 Activity A, 然 后 直接 又 启 
动 Activity B. 这 时 系统 需要 停止 Activity A. 则 会 调用 Activity A 的 
onSaveInstanceState() 来 保存 Activity A 的 界面 临时 信息 。 当 用 户主 动 关 闭 Activity B 
时 ,Activity B 的 onSaveInstanceState() 不 会 被 调用 ,因为 是 用 户主 动 关 闭 Activity B 而 
不 是 系统 暂停 的 ,所 以 当 Activity A 重新 显示 在 屏幕 上 后 ,Activity A 可 以 选择 调用 
onRestoreInstanceState() 用 以 恢复 之 前 保存 的 Activity A 的 状态 信息 。 
Activity 状态 保存 和 恢复 函数 onSaveInstanceState() 和 onRestoreInstanceState O 的 
说 明 参 见 表 4. 2。 
表 4.2 Activity 状态 保存 /恢复 的 事件 回调 函数 
A 数 说 明 
onSavelnstanceState() 暂停 或 停止 Activity 前 调用 该 函数 ,用 以 保存 Activity 的 临时 状态 信息 
onRestorelnstanceState() | 恢复 onSavelnstanceState() 保 存 的 Activity 状态 信息 


onSavelInstanceState C) 函数 会 将 界面 临时 信息 保存 在 Bundle 中 ,onCreate() 函数 和 
onRestoreInstanceState() 函 数 都 可 以 恢复 这 些 保存 的 信息 。 一 般 简 化 的 做 法 是 在 onCreate() 
函数 中 恢复 保存 的 信息 ,但 有 些 特殊 的 情况 下 还 是 需要 使 用 onRestoreInstanceState() PR 
数 恢复 保存 的 信息 ,如 必须 在 界面 完全 初始 化 完毕 后 才能 进行 的 操作 ,或 需要 由 子 类 来 
确定 是 否 采用 默认 设置 等 。 

在 Activity 的 生命 周期 中 ,并 不 是 所 有 的 事件 回调 函数 都 会 被 执行 ,但 如 果 被 调用 ， 
则 会 遵循 图 4. 4 描述 的 调用 顺序 。 

从 图 4.4 中 可 知 ,Activity 的 生命 周期 可 分 为 完全 生命 周期 .可 视 生 命 周期 和 活动 生 
命 周 期 。 每 种 生命 周期 中 包含 不 同 的 事件 回调 函数 。 

完全 生命 周期 从 Activity 建立 到 销毁 的 全 部 过 程 . 始 于 onCreate ( ), 结束 于 
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(1) (3) (9) 


onRestore 
InstanceState 


(5 
onSave 
InstanceState 


s 
(4) 
onResume onPause 
(6) 
onRestart 
活动 生命 周期 


可 视 生命 周期 
全 生命 周期 


图 4.4 Activity 事件 回调 函数 的 调用 顺序 


(8) 
onStop 
onCreate onDestroy 


onDestroyO 。 一 般 情 况 下 .开发 人 员 在 onCreate() 中 初始 化 Activity 所 能 使 用 的 全 局 资 
源 和 状态 ,并 在 onDestroy() 中 释放 这 些 资源 。 例 如 ,Activity 中 使 用 后 台 线 程 , 则 需要 在 
onCreate() 中 创建 线程 ,在 onDestroy() 中 停止 并 销毁 线程 。 在 一 些 极端 的 情况 下 ， 
Android 系统 会 不 调用 onDestroy O 函数 ,而 直接 终止 进程 。 

可 视 生命 周期 是 Activity 在 界面 上 从 可 见 到 不 可 见 的 过 程 , 开 始 于 onStart O , 结 ? 
于 onStop()。onStart() 一 般 用 来 初始 化 或 启动 与 更 新 界面 相关 的 资源 。onStop() 一 般 
用 来 暂停 或 停止 一 切 与 更 新 界面 相关 的 线程 、 计 时 器 或 Service 等 ,因为 在 调用 onStop() 
后 ,Activity 对 用 户 不 再 可 见 , 更 新 用 户 界面 也 就 没有 任何 实际 意义 。onRestart() 函 数 
在 onSart() 前 被 调用 ,用 来 在 Activity 从 不 可 见 变 为 可 见 的 过 程 中 进行 一 些 特定 的 处 理 
过 程 。 因 为 Activity 不 断 从 可 见 变 为 不 可 见 ,再 从 不 可 见 变 为 可 见 ,所 以 onStart() 和 
onStop( ) 会 被 多 次 调用 。 另 外 ,onStart() 和 onStop() 也 经 常 被 用 来 注册 和 注销 
BroadcastReceiver。 例 如 ,使 用 者 可 以 在 onStart() 中 注册 一 个 BroadcastReceiver, 用 来 
监视 某 些 重要 的 广播 消息 ,并 使 用 这 些 消 息 更 新 用 户 界 面 中 的 相关 内 容 , 然 后 在 onStop() 
中 注销 BroadcastReceiver。 

活动 生命 周期 是 Activity 在 屏幕 的 最 上 层 , 并 能 够 与 用 户 进行 交互 的 阶段 ,开始 于 
onResume() ,结束 于 onPause()。 因 为 在 Activity 的 状态 变换 过 程 中 onResume() 和 
onPause() 经 常 被 调用 ,因此 这 两 个 函数 中 应 使 用 简单 ,高效 的 代码 。 

ER A. 1 中 “是 否 可 终止 "表示 事件 回调 函数 在 执行 过 程 中 或 返回 后 是 否 可 以 被 
Android 系统 终止 ,否定 答案 表示 在 函数 从 被 调用 后 ,直到 函数 返回 前 ,Android 系统 不 
能 够 终止 该 进程 ;肯定 答案 表示 在 当前 的 函数 返回 前 ,Android 系统 随时 可 以 终止 该 
进程 。 

从 图 4.4 的 Activity 事件 回调 函数 的 调用 顺序 上 分 析 ,onStop() 是 第 一 个 被 标识 为 
“可 终止 ?的 函数 ,因此 在 onStop() 和 onDestroy() 函 数 的 执行 过 程 中 随时 能 被 Android 
系统 终止 。 因 此 ,onPause() 常 用 来 保存 持久 数据 ,如 界面 上 的 用 户 输入 信息 等 。 很 多 时 
候 开 发 人 员 不 清楚 何 时 该 使 用 onPause() . 何 时 该 使 用 onSaveInstanceState() ,因为 这 两 
个 函数 都 可 以 用 来 保存 界面 的 用 户 输入 数据 。 它 们 的 主要 区 别 在 于 两 个 函数 保存 数据 
的 性 质 和 方法 不 同 ,onPause() 一 般 用 于 保存 持久 性 数据 ,并 将 数据 保存 在 存储 设备 上 的 
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文件 系统 或 数据 库 系统 中 ;而 onSaveInstanceState() 主要 用 来 保存 动态 的 状态 信息 , 信 
息 一 般 保存 在 Bundle 中 。Bundle 是 保存 多 种 格式 
数据 的 对 象 ,onSaveInstanceState() 将 数据 保存 在 
Bundle 中 ,系统 在 调用 onRestoreInstanceState ( 
和 onCreate() 时 ,会 将 保存 在 Bundle 中 的 数据 
取出 。 
图 4.5 ActivityLifeCycle 示例 用 户 界 面 为 了 能 够 更 好 地 理解 Activity 事件 回调 函数 
的 调用 顺序 ,下 面 用 ActivityLifeCycle 示例 来 进行 
说 明 ,ActivityLifeCycle 示例 的 运行 界面 如 图 4. 5 所 示 。 
下 面 给 出 ActivityLifeCycleActivity. java 文件 的 全 部 代码 。 


| ActivityLifeCycle 


1 package edu.hrbeu.ActivityLifeCycle; 

2 

3 import android.app.Activity; 

4 import android.os.Bundle; 

5 import android.util.Iog; 

6 

7 public class ActivitylifeCycleActivity extends Activity ( 

8 private static String TAG- "LIFECYCIE"; 

9 // 完 全 生命 周期 开始 时 被 调用 ,初始 化 Activity (D 
10 G Override 

1 public void onCreate (Bundle savedInstanceState) { 

12 Super .onCreate (savedInstanceState) ; 

13 setContentView (R. layout main) ; 

14 Log.i(TAG, "(1) onCreate()") ; 

15 

16 // 定 义 按钮 和 按钮 监听 函数 ,通过 用 户 点 击 按钮 调用 finish() 函 数 结束 程序 
37. Button button- (Button)findViewById(R.id.btn finish); 

18 button.setOnClickListener (new View.OnClickListener() { 

19 public void onClick(View view) ( 

20 finish(; 

21 ) 

22 pn; 

23 } 

24 

25 // 可 视 生命 周期 开始 时 被 调用 ,对 用 户 界面 进行 必要 的 更 改 (2 
26 @ Override 

27 public void onStart() ( 

28 Super.onstart (); 

29 log.i (TAG, "(2) onStart ()") ; 

30 i 
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// 在 onstart() 后 被 调用 ,用 于 恢复 onsaveInstancestate() 保 存 的 用 户 界面 // 信 息 


@ Override 

public void onRestoreInstanceState (Bundle savedInstanoeState) { 
Super.onRestoreInstanceState (savedInstanceState) ; 
Log.i (TAG, "(3) onRestoreInstanceState () ") ; 


// 在 活动 生命 周期 开始 时 被 调用 ,恢复 被 oqPause() 停 止 的 用 于 界面 更 新 的 资源 


G Override 

public void onResume() ( 
super.onResure () ; 
Log.i (TAG, "(4) anResume ()") ; 


/在 onPause() 后 被 调用 ,保存 界面 临时 信息 

G Override 

public void onSaveInstanceState (Bundle savedInstanoeState) { 
Super .onSaveInstanceState (savedInstanceState); 
Log.i(TAG, "(5) onSaveInstanceState () ") ; 


// 在 重新 进入 可 视 生 命 周期 前 被 调用 , 载 人 界面 所 需要 的 更 改 信息 
@ Override 
public void onRestart() ( 

Super.onFestart () ; 

1og.i (TAG, "(6) onRestart )") ; 


// 在 活动 生命 周期 结束 时 被 调用 ,用 来 保存 持久 的 数据 或 释放 占用 的 资源 
G Override 
public void onPause() ( 

Super.onPause () ; 

1og.i (TAG, "(7) onPause") ; 


// 在 可 视 生命 周期 结束 时 被 调用 ,用 来 释放 占用 的 资源 
@ Override 
public void onstop() { 

super.onStop() ; 

Log.i(TAG, "(8) onStopQ"); 


(3) 


(9 


(5 
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72 } 

B 

74 // 在 完全 生命 周期 结束 时 被 调用 ,释放 资源 ,包括 线程 .数据 连接 等 (9 
75 G Override 

76 public void onDestroy() ( 

TI Super.onDestroy () ; 

78 Log.i(TAG, "(9) onDestroy 0"); 

79 } 

80 } 


上 面 的 程序 主要 通过 在 生命 周期 函数 中 添加 “日 志 点 ”的 方法 进行 调试 ,程序 的 运行 
结果 将 会 显示 在 LogCat 中 。LogCat 和 “日 志 点 ”的 使 用 方法 ,请 参考 4. 4. 1 节 内 容 。 为 
了 显示 结果 易于 观察 和 分 析 , 在 LogCat 设置 过 滤器 Life, 过 滤器 的 条 件 为 “标签 = 
LIFECYCLE”. 日志 信 息 中 的 数字 标识 与 图 4.4 的 函数 编号 一 致 ,因此 ,可 以 参考 图 4.4 
阅读 下 面 内 容 。 

COD 完全 生命 周期 。 

为 了 观察 Activity 从 启动 到 关闭 所 调用 的 全 部 生命 周期 函数 的 顺序 ,首先 正常 启动 
ActivityLifeCycle, 然 后 单 击 用 户 界面 的 “结束 程序 ”按钮 关闭 程序 。LogCat 的 输出 结 
如 图 4.6 所 示 。 


level | Time. PD Application Tag Text 

(o aen 578  edu.hrbeuActivityLifeCycle LIFECYCLE — (1)_onCreate()_ —- 
I z: 578 edu.hrbeu.ActivityLifeCycle LIFECYCLE (2) onStart() 

I 10-21 01:13:12.947 578 edu.hrbeu.ActivityLifeCycle LIFECYCLE (4) onResume () 

I 10-21 01:17:23.328 578 edu.hrbeu.ActivityLifeCycle LIFECYCLE (7) onPause() 

I 10-21 01:17:25.817 578 edu.hrbeu.ActivityLifeCycle LIFECYCLE (8) onStop() 

I 10-21 01:17:25.817 578 edu.hrbeu.ActivityLifeCycle LIFECYCLE (9) onDestroy() 


图 4.6 完全 生命 周期 的 LogCat 输出 


从 图 4.6 可 以 得 知 ,函数 调用 顺序 如 下 : (1)onCreate 一 (2)onStart 一 (4)onResume 
—-—-(T)onPause- (8)onStop-* (9)onDestroy。 

在 Activity 启动 时 ,系统 首先 调用 onCreate OO 函数 分 配 资源 ,然后 调用 onStart O Jf 
Activity 显示 在 屏幕 上 ,之 后 调用 onResume() 获 取 屏 幕 焦 点 ,使 Activity 能 够 接受 用 户 
的 输入 ,这 时 用 户 就 能 够 正常 使 用 这 个 Android 程序 了 。 

用 户 单 击 “ 结 束 程序 ”按钮 ,会 导致 Activity 关闭 ,系统 会 相继 调用 onPause()、 
onStop() 和 onDestroy() ,释放 资源 并 销毁 进程 。 因 为 Activity 关闭 后 ,除非 用 户 重新 启 
动 应 用 程序 ,否则 这 个 Activity 不 会 再 出 现在 屏幕 上 ,因此 系统 直接 调用 onDestroy() 销 
上 毁 进 程 , 且 没 有 调用 onSaveInstanceState O 函数 来 保存 Acitivity 状态 。 

(2) 可 视 生 命 周 期 。 

在 Activity 启动 后 ,如 果 启 动 其 他 的 程序 , 原 有 的 Activity 会 被 新 启动 程序 的 
Activity 完全 遮挡 ,因此 原 有 Activity 会 进入 停止 状态 。 如 果 将 新 启动 的 程序 关闭 , 则 原 
有 Activity 从 停止 状态 恢复 到 活动 状态 。 
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为 了 能 够 分 析 上 述 状 态 转换 过 程 中 的 函数 调用 顺序 ,首先 正常 启动 
AcetivityLifeCycle, 然 后 通过 “拨号 键 ? 启 动 内 置 的 拨号 程序 ,再 通过 * 回 退 键 5 退 出 拨号 程 
序 , 使 ActivityLifeCycle 重新 显示 在 屏幕 中 。LogCat 的 输出 结果 如 图 4.7 所 示 。 


level Time PID | Application Tag Text 

(I 10-22 06:57:24.946 — 567  edu.hrbeu.ActivityLifeCycle LIFECYCLE ^ (1) onCreate() - 

I 10-22 06:57:25.056 567  edu.hrbeu.ActivitylifeCycle LIFECYCLE (2) onStart() 

I 10-22 06:57:25.056 567  — edu.hrbeu.ActivityLifeCycle LIFECYCLE (4) onResume() 

I 10-22 06:57:31.687 567  edu.hrbeu.ActivityLifeCycle LIFECYCLE (7) onPause() 

I 10-22 06:57:34.276 567  edu.hrbeu.ActivityLifeCycle LIFECYCLE (S) onSaveInstanceState () 
I 10-22 06:57:34.329 567 edu.hrbeu.ActivityLifeCycle LIFECYCLE (8) onStop() 

I 10-22 06:57:39.867 567  edu.hrbeu.ActivityLifeCycle LIFECYCLE (6) onRestart() 

I 10-22 06:57:39.867 567  edu.hrbeu.ActivityLifeCycle LIFECYCLE (2) onStart() 

I 10-22 06:57:39.886 567  edu.hrbeu.ActivityLifeCycle LIFECYCLE (4) onResume() 


图 4.7 可 视 生命 周期 的 LogCat 输出 


从 图 4.7 可 以 得 知 ,函数 调用 顺序 如 下 : (1)onCreate 一 (2)onStart 一 (4)onResume 
> 一 (7)onPause 一 (5)onSaveInstanceState 一 (8)onStop 一 一 (6)onRestart 一 (2)onStart 
> (A)onResume, 

Activity 启动 时 的 函数 调用 顺序 仍 为 (1) 一 (2) 一 (4), 当 内 置 的 拨号 程序 被 启动 时 , 原 有 
的 Activity 被 完全 覆盖 ,系统 首先 调用 onPause() 函 数 ,然后 调用 onSaveInstanceState() 函数 
保存 Activity 状态 ;最 后 调用 onStop() ,停止 对 不 可 见 Activity 的 更 新 。 

在 用 户 关 闭 拨 号 程序 后 ,系统 调用 onRestart() 恢 复 界面 上 需要 更 新 的 信息 ,然后 调 
用 onStart() 和 onResume() 重 新 显示 Activity, 并 接受 用 户 交互 。 

Android 系统 虽然 调用 了 onSaveInstanceState ( ) 保存 站 
Activity 的 状态 ,但 是 ,因为 Activity 并 没有 被 销毁 ,所 以 没有 必 nt Settings 
要 调用 onRestoreInstanceStateO X & fi f£ If] Activity 状态 。 > 

如 果 用 户 在 Dev Tools — Development Settings > 
Immediately destroy activities 下 开启 IDA ,如 图 4. 8 所 示 ,被 
其 他 程序 遮挡 的 Activity 会 被 立即 终止 , 这 样 被 遮挡 的 
Activity 重新 显示 在 屏幕 上 时 ,系统 会 调用 
onRestoreInstanceState() 恢 复 Activity 销毁 前 的 状态 。 

从 图 4. 9 可 以 得 知 ,函数 调用 顺序 如 下 : (1)onCreate 一 


(2) onStart > (4) onResume 一 一 (7)onPause 一 (5)onSave- 


InstanceState— (8) onStop— — ( 1) onCreate— (2) onStart — 


(GDonRestoreInstanceState- (4)onResume, 图 4.8 开启 IDA 选项 
IDA 未 开启 前 ,用 户 单 击 回 退 按钮 后 的 函数 调用 顺序 是 (6) 

一 (2) 一 (4) ,开启 IDA 后 的 函数 调用 顺序 是 (1) 一 (2) 一 (3) 一 (4)。 由 此 可 见 开启 IDA 导致 

Android 系统 在 用 户 打 开 其 他 程序 时 销毁 了 原来 已 经 打开 的 Activity, 这 个 被 销毁 的 Activity 

出 现在 用 户 的 屏幕 上 前 ,系统 额外 调用 了 onCreate() 和 onRestoreInstanceState O 函数 ， 

用 以 恢复 Activity 在 销毁 前 所 保存 的 数据 。 
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LETTER (第 2 版 ) 


Level Time PID Application Tag Text 

1 10-22 07:13:33.476 772 edu.hrbeu.ActivityLifeCycle LIFECYCLE (1) onCreate() 

1 :13: 7:2 edu.hrbeu.ActivityLifeCycle LIFECYCLE (2) onStart() 

I 772 edu.hrbeu.ActivityLifeCycle LIFECYCLE (4) onResume () 

I T2 edu.hrbeu.ActivityLifeCycle LIFECYCLE (7) onPause () 

I 10-22 07:13:50.966 T2 edu.hrbeu.ActivityLifeCycle LIFECYCLE (5) onSaveInstanceState() 
I 10-22 07:13:50.966 172 edu.hrbeu.ActivityLifeCycle LIFECYCLE (8) onStop() 

I 10-22 07:14:00.287 833 edu.hrbeu.ActivityLifeCycle LIFECYCLE (1) onCreate() 

1 10-22 07:14:00.296 — 833 edu.hrbeu.ActivityLifeCycle LIFECYCLE (2) onStart() 

1 10-22 07:14:00.327 — 833 edu.hrbeu.ActivityLifeCycle LIFECYCLE (3) onRestoreInstanceState () 
1 10-22 07:14:00.336 — 833 edu.hrbeu.ActivityLifeCycle LIFECYCLE (4) onResume () 


图 4.9 FA IDA 的 可 视 生命 周期 LogCat 输出 
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在 Android 程序 开发 过 程 中 ,出 现 错误 (bug) 是 不 可 避免 的 事情 。 一 般 情况 下 ,语法 
错误 会 被 集成 开发 环境 检测 到 ,并 提示 开发 人 员 错 误 的 位 置 以 及 修改 方法 。 但 逻辑 错误 
就 不 那么 容易 发 现 了 ,通常 只 有 程序 在 模拟 絮 或 硬件 设备 上 运行 才能 够 发 现 。 迪 辑 错误 
的 定位 和 分 析 是 件 困难 的 事情 ,尤其 是 代码 量 较 大 且 结 构 复 杂 的 应 用 程序 , 仅 赁 直觉 很 
难 快 速 找到 并 解决 问题 。 因 此 ,Android 系统 提供 了 几 种 调试 工具 ,用 于 定位 、 分 析 及 修 
复 程 序 中 出 现 的 错误 ,这 些 工 具 包括 LogCat 和 DevTools 。 
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LogCat 是 用 来 获取 系统 日 志 信 息 的 工具 ,并 且 它 可 以 显示 在 Eclipse 集成 开发 环境 
中 。LogCat 能 够 捕获 的 信息 包括 Dalvik 虚拟 机 产生 的 信息 、 进 程 信息 、ActivityManager 
信息 、PackageManager 信息 、Homeloader 信息 、 
WindowsManager 信息 、Android 运行 时 信息 和 
应 用 程序 信息 等 。 在 Eclipse 的 默认 开发 模式 下 
没有 LogCat 的 显示 页 ,用 户 可 以 使 用 Window 


Q Allocation Tracker 


一 Show View 一 Other.. 命 令 打开 Show View 的 B Devices 
选择 菜单 ,然后 在 Andoird > LogCat 中 选择 i-re 
LogCat, 如 图 4. 10 所 示 。 日 Heap 

这 样 ,LogCat 便 显示 在 Eclipse 的 下 方 区 aum 
域 , 如 图 4. 11 所 示 。LogCat 右上 方 的 5 个 字母 人 
LV].ED].LE.EW TREE]. Az 5 种 不 同类 型 的 biis 
日 志 信 息 ,分 别 是 详细 信息 (Verbose) .调试 信息 ni i 
(Debug) ,通告 信息 (Info)、 警 告 信息 CWarn) 和 
错误 信息 (Error) 。 不 同类 型 日 志 信 息 的 级 别 是 ox] 


不 相同 的 ,级 别 最 高 的 是 错误 信息 ,其 次 是 警告 L 一 一 一 J 
信息 ,然后 是 通知 信息 和 调试 信息 ,级 别 最 低 的 图 4.10 Show View 中 选择 LogCat 
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是 详细 信息 。 在 LogCat 中 ,用 户 可 以 通过 5 个 字母 图 标 选 择 显 示 的 信息 类 型 ,同时 级 别 
比 选择 类 型 高 的 信息 也 可 以 在 LogCat 中 显示 ,但 级 别 低 于 选 定 的 信息 则 会 被 忽略 掉 。 


Saved Filters + = f 


All messages (no filters) 
edu hbou LogCat (Sesion F | = i Time zm, 
D 10-20 13:36:15.354 — 1170 


earch for messages. Accepts Java regexec. Prefix with pidt, app; tag: or text to limit scope. 


10-20 13:36:15.393 1170 
10-20 13:36:15.393 1170 
10-20 13:36:15.393 1170 
10-20 13:36:17.622 285 


.. Displayed com.android.develcpmert/.Prc 
10-20 13:36:33.983 170 " -i GC CONCURAENT freed 419K, 61 free 1037y 
i = 


10-20 13:36:18 85 


图 4.11 Eclipse 中 的 LogCat 


即使 用 户 指定 了 所 显示 日 志 信息 的 级 别 ,仍然 会 产生 很 多 日 志 信 息 ,很 容易 让 用 户 
不 知 所 措 。LogCat 还 提供 了 “过 滤 ” 功 能 ,位 于 右上 角 的 十 号 和 一 号 ,分 别 是 添加 和 删除 
过 滤器 。 用 户 可 以 根据 日 志 信息 的 标签 (Tag)、 产 生日 志 的 进程 编号 (PID) 或 信息 等 级 
(Level) ,对 显示 的 日 志 内 容 进行 过 滤 。 

在 Android 程序 调试 过 程 中 ,首先 需要 引入 android. util. Log 包 , 然 后 使 用 Log. vO, 
Log. dO „Log. iO „Log. wO 和 Log. eO 5 个 函数 在 程序 中 设置 “日 志 点 ”。 每 当 程序 运 
行 到 “日 志 点 ”时 ,应 用 程序 的 日 志 信 息 便 被 发 送 到 LogCat 中 ,可 以 根据 “日 志 点 ”信息 是 
否 与 预期 的 内 容 一 致 ,判断 程序 是 否 存 在 错误 。 之 所 以 使 用 5 个 不 同 的 函数 产生 日 志 ， 
主要 是 为 了 区 分 日 志 信 息 的 类 型 ,其 中 ,Log. v() 用 来 记录 详细 信息 ,Log. d() 用 来 记录 调 
试 信息 ,Log. i() 用 来 记录 通告 信息 ,Log. w() 用 来 记录 警告 信息 ,Log. e() 用 来 记录 错误 
信息 。 

在 下 面 的 程序 中 ,演示 了 Log 类 的 具体 使 用 方法 。 


package edu.hrbeu.LogCat; 


1 

2 

3 import ardroid.arp.Activity; 
4 inport ardroid.os.Burdle; 
5 — import android.util.log; 
6 

7 

8 

9 


public class LogCatActivity extends Activity ( 
final static String TAG- "IOGCAT"; 


@ Override 
10 public void onCreate (Bundle savedInstanceState) { 
AT Super .onCreate (savedInstanceState) ; 
12 setContentView (R. layout main); 
13 
14 Log.v (TAG, "Verbose") ; 


15 Log.d(I2G, Debug") ; 
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16 Icg.i(IAG, "Info") ; 
17 Log.w (TAG, "Wam") ; 
18 Iog.e (TAG, Error") ; 
19 ¥ 

20 ] 


为 了 使 用 Log 类 中 的 函数 ,首先 在 程序 第 5 行 引入 android. util. Log 包 ; 然 后 在 第 8 
行 定义 标签 ,标签 帮助 用 户 在 LogCat 中 找到 目标 程序 生成 的 日 志 信息 ,同时 也 能 够 利用 
标签 对 日 志 进 行 过 滤 ;第 14 行 记 录 一 个 详细 信息 ,Log. vO 〇 函数 的 第 一 个 参数 是 日 志 
标签 ,第 二 个 参数 是 实际 的 信息 内 容 ; 第 15 行 到 第 18 行 分 别 产生 了 调试 信息 .通告 信 
息 .警告 信 息 和 错误 信息 。 

程序 运行 后 ,LogCat 捕获 到 应 用 程序 发 送 的 日 志 信 息 , 显 示 结 果 如 图 4.12 所 示 。 在 
LogCat 中 显示 了 标签 为 LOGCAT 的 日 志 信息 共 5 条 ,并 以 不 同 颜色 加 以 显示 。 可 见 ， 
LogCat 对 不 同类 型 的 信息 使 用 了 不 同 的 颜色 加 以 区 别 。 


Saved Filters d = 国 Search for messages. Accepts Java regexes. Prefx with pid, app: tag: or text: to limit scope. 


Al fit 
messages (no fiter | Time ——ÓÀ € 
Y 


Y-18-20 13:53:07:924; 2182. Jearteulegcar- — |nxwxar | vesose 
D " 

X 

t : 
D 10-20 13:53:07.72€ -Arbeu.] Grailoc goldfish Emulator without GPU emulation detected. 


^ 


图 4.12. LogCat 工程 的 运行 结果 


如 果 能 够 使 用 LogCat 的 过 滤器 , 则 可 以 使 显示 的 结果 更 加 清晰 。 下 面 使 用 在 
LogCat 右 侧 的 十 号 ,添加 一 个 名 为 LogcatFilter 的 过 滤器 ,并 设置 过 滤 条 件 为 “标签 一 
LOGCAT”, 具 体 设置 方法 如 图 4. 13 所 示 。 
本 一 一 ”me ae | 
| Logcat Message Filter Settings 


Filter logcat messages by the source's tag, pid or minimum log level. 
Empty fields will match all messages. 


Filter Name: Logcatfilter 


by Log Tag: LOGCAT| 
by Log Message: 
by PID: 


by Application Name: 


by Log Level: [verbose ~ 


[o] Coe JL em 


4.13 LogCat 过 滤器 
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过 滤器 条 件 设 置 好 后 ,LogcatFilter 过 滤 后 的 日 志 信 息 如 图 4. 14 所 示 。 在 这 之 后 ， 
无 论 什么 类 型 的 日 志 信 息 ,属于 哪 一 个 进程 ,只 要 标签 为 LOGCAT, 都 将 显示 在 
LogcatFilter 区 域内 。 


区 Problems | @ Javadoc |© Declaration | E] Console 


Saved Filters = B? | Search for messages. Accepts Java regexes. Prefix with pid: app: tag: o [verbose. ] Il I| (E) 


All messages (no filters) (34) 


L Time PID Application T Text 
edu.hrbeu.LogCat (Session Filter) ~ 2 上 s 
V 10-20 13:53:07.324 — 2182  — edu.hrbeu.LogCat LOGCAT Verbose 


D 10-20 13:53:07. 


Logcatfilter 
LOGCAT Debug 


图 4.14 LogCat 过 滤 后 的 输入 结果 
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在 Android 模拟 器 中 ,内置 了 一 个 用 于 调试 和 测试 的 工具 Dev Tools, Dev Tools 包 
括 了 一 系列 各 种 用 途 的 小 工具 ,包括 AccountsTester、Bad Behavior, Configuration, 
Connectivity, Development Settings, Google Login Service, Instrumentation, Media 
Scanner, Package Browser, Pointer Location, Running processes, Sync Tester 和 
Terminal Emulator。 从 模拟 器 的 应 用 程序 列表 中 可 以 找到 启动 Dev Tools 的 图 标 ,启动 
Dev Tools 后 的 显示 界面 如 图 4.15 所 示 。 


[DES 


AccountsTester 


Apps Widgets 


四 9 


APiDemos Browser ^ Calculator ^ Calendar 


momes 


Camera Custom Local Dev Tools 


Bad Behavior 


Configuration 


FEE 


Downloads Email Galley Gestures Bui 


E T © 


HelloAndroid Messaging Music 


Lea 


Phone Search Settings 


Connectivity 


Development Settings 


Google Login Service 


Instrumentation 


4.15 Dev Tools 使 用 界面 
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在 这 些 工 具 中 ,经 常用 到 的 有 设置 调试 选项 的 
Development Settings. 查看 已 经 安装 程序 包 的 Package 


Browser, 确 定 触摸 点 位 置 的 Pointe 


行进 程 的 Running processes, 还 有 连接 底层 Linux 操作 系 


统 的 虚拟 终端 软件 Terminal Emul 
-介绍 这 些 经 常 使 用 的 小 工具 的 功 


1. Development Settings 


r Location, 查 看 当前 运 


(none) 


Wait for debugger 


ator。 后 面 的 内 容 将 逐 
能 和 使 用 方法 。 


No Pointer Location 
Show running pro 
Show screen updi 


StrictMode visual indicator: build varia 


Development Settings 中 包含 了 程序 调试 的 相关 选项 ， Disable compatibility mode 


如 图 4. 16 所 示 。 


No App F imit 


如 果 和 希望 启动 Development Settings 中 的 某 项 功能 ， Immediately destroy activities 
只 需要 单 击 功能 项 前 面 的 复 选 框 ,出 现 绿色 的 “对 号 "表示 cocos 
功能 启用 。 功 能 启用 后 ,模拟 器 会 自动 保存 设置 ,即使 再 次 。 sae 


启动 模拟 器 用 户 的 选择 内 容 仍 


会 存在 。Development 图 4.16 Development Settings 


Settings 每 个 选项 的 具体 说 明 可 以 参考 表 4. 3。 


表 4.3 


Development Settings 选项 


说 明 


Debug App 


为 Wait for debugger 选项 指定 应 用 程序 ,如 果 不 指定 (选择 
none) , 则 Wait for debugger 选项 将 适用 于 所 有 应 用 程序 ， 
Debug App 可 以 有 效 地 防止 Android 程序 长 时 间 停 留 在 断 点 
而 产生 异常 


Wait for debugger 


阻塞 加 载 应 用 程序 ,直到 关联 到 
Activity 的 onCreate( ) 函 数 进行 断 点 


f (Debugger). HFE 
周 试 


Show running processes 


在 屏幕 右上 角 显 示 运 行 中 的 进程 


Show screen updates 


选中 该 选项 时 ,界面 上 任何 被 重 绘 的 矩形 区 域 会 闪现 粉红 
色 , 有 利于 发 现 界面 中 不 必要 的 重 绘 区 域 


No App Process limit 


允许 同时 运行 进程 的 数量 上 限 


Immediately destroy activities 


Activity 进入 停止 状态 后 立即 销毁 ,用 于 测试 在 函数 
onSaveInstanceState() .onRestoreInstanceState() 和 onCreate() 中 


的 代码 


Show CPU usage 


在 屏幕 顶端 显示 CPU 使 用 率 , 上 层 红线 显示 总 的 CPU 使 用 


Show background 


应 用 程 有 Activity 显示 时 ,直接 显示 背景 面板 ,一 般 这 种 
情况 仅 在 调试 时 出 现 


Show sleep state on LED 


在 休眠 状态 下 开启 LED 


Windows Animation Scale 窗口 动画 模式 
Transition Animation Scale 渐变 动画 模式 
Light Hinting 提示 模式 


Show GTalk service connection status 


显示 GTalk 服务 连接 状态 
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2. Package Browser 


Package Browser 是 Android 系统 中 的 程序 包 查 看 工具 ,能 够 详细 显示 已 经 安装 到 
Android 系统 中 的 程序 信息 ,包括 包 名 称 、 应 用 程序 名 称 、 图 标 、 进 程 、 用 户 ID ,版 本 apk 
文件 保存 位 置 和 数据 文件 保存 位 置 等 ,而 且 能 够 进一步 查看 应 用 程序 所 包含 的 Activity、 
Service, BroadcastReceiver 和 Provider 的 详细 信息 。 图 4. 17 是 在 Package Browser 中 查 
看 Android keyboard 程序 的 相关 信息 。 


3. Pointer Location 


Pointer Location 是 屏幕 点 位 置 查看 工具 ,能 够 显示 触摸 点 的 X 轴 坐 标 和 YY 轴 坐 标 。 
图 4. 18 是 Pointer Location 的 使 用 画面 。 


$ Package Browser 


WWE Android keyboard 


Restart 
© Android System 
D and 


Lo API Demos 
om.example.android.aj 


NI 


Z Calculator 


Calendar Activities 
sien cma AllinOneActivity 
Calendar Storage 


mein LaunchActivity 


图 4.17 Package Browser 4.18 Pointer Location 


4. Running processes 


Running processes 能 够 查看 在 Android 系统 中 正在 运行 的 进程 ,并 能 查看 进程 的 详 
细 信 息 ,包括 进程 名 称 和 进程 所 调用 的 程序 包 。 图 4. 19 是 Android 模拟 器 所 运行 进程 
的 列表 和 com. android. phone 进程 的 详细 信息 。 


5. Connectivity 


Connectivity 允许 用 户 控制 Wi-Fi、 屏 幕 锁定 界面 .MMS 和 导航 的 开启 与 关闭 ,并 可 
以 设置 Wi-Fi 和 屏幕 锁定 界面 的 开启 关闭 周期 。 其 中 “Enable Wifi" fI" Disable Wifi” 分 
别 是 控制 了 Wi-Fi 的 开启 和 关闭 ,“Start Wifi Toggle” 和 “Stop Wifi Toggle” 是 Wi-Fi 周 
期 性 开启 和 关闭 的 开关 ,“Cycles done” 后 面 的 数值 记录 了 Wi-Fi 开启 和 关闭 的 次 数 。 
图 4. 20 是 Connectivity 的 运行 界面 。 
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$ Running processes 


nnectivity 
com.android.development Enable Wifi Disable Wifi 


com.android.inputmethod.latin 


Start Wifi Toggle Stop Wifi Toggle 


com.android.launcher Wifi on (ms): 120000 


com.android.phone Wifi off (ms): 120000 


com.android.systemui 
á Start Screen Toggle Stop Screen 


Toggle 
system 


120000 


12000 


Start MMS Stop MMS 


Start HiPri Stop HiPri 


4.19 Running processes Æ 4.20 Connectivity 的 运行 界面 


6. Configuration 


Configuration 中 详细 列 出 了 Android % 
比例 .屏幕 初始 方向 、 触 


统 的 配置 信息 ,包括 屏幕 分 辩 率 .字体 缩放 
型 .导航 ,本 地 语言 和 键盘 等 信息 ,如 图 4. 21 所 示 


yx 


7. Bad Behavior 


Mr 


Bad Behavior 中 可 以 模拟 各 种 程序 崩 演 和 失去 响应 的 情况 ,如 主 程序 崩溃 、 系 统 服 务 
AE .启动 Service 时 失去 响应 和 启动 Activity 时 失去 响应 等 。Bad Behavior 界面 如 


图 4. 22 所 示 
RE ood Behavior 
? Crash the main app thread 


nfigui 


ale=1 
rdHidden=1 


Crash an auxiliary app thread 
Crash ti ative process 


Crash the system server 


Report a WTF condition 


ANR (Stop responding for 20 
seconds) 


ANR starting an Activity 
ANR receiving a broadcast Intent 


ANR starting a Service 


图 4.21 Configuration Æ 4.22 Bad Behavior 
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在 表 4.4 中 , 列 出 了 Bad Behavior 中 所 有 可 以 模拟 的 事件 ,并 对 每 个 事件 给 出 了 简 


要 的 说 明 。 
表 4.4 Bad Behavior 选项 
选 项 说 明 
Crash the main app thread 应 用 程序 主线 程 崩 溃 
Crash an auxiliary app thread 应 用 程序 工作 线程 崩溃 
Crash the native process 本 地 进程 崩溃 
Crash the system server 系统 服务 器 崩溃 
Report a WTF condition 报告 WTF 


ANR(Stop responding for 20 seconds) 
ANR starting an Activity 

ANR starting a broadcast Intent 

ANR starting a Service 

System ANR (in ActivityManager) 
Wedge system (5 minutes system ANR) 


Z 


应 用 程序 无 响应 (Application Not Responding. ANR)20 fF 
启动 Activity 时 应 用 程序 无 响应 

启动 广播 信息 时 应 用 程序 无 响应 

启动 Service 时 应 用 程序 无 响应 

Activity 管理 器 级 别 ANR 

Wedge 在 5 分 钟 内 无 响应 
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1. 简 述 Android 系统 前 台 进 程 .可 见 进程 .服务 进程 .后 台 进程 和 空 进程 的 优先 级 排 


序 原因 。 


2. 简 述 Android 系统 的 4 种 基本 组 件 Activity, Service, BroadcastReceiver 和 


ContentProvider 的 用 途 。 


3. 简 述 Activity 生命 周期 的 4 种 状态 ,以 及 状态 之 间 的 变换 关系 。 
4. 简 述 Activity 事件 回调 函数 的 作用 和 调用 顺序 。 


^W sn 
Android 用 户 界 面 


用 户 界 面 是 应 用 程序 开发 的 重要 组 成 部 分 ,决定 了 应 用 程序 是 否 美观 、 易 用 。 通 过 
本 章 的 学 习 可 以 让 读者 熟悉 Android 用 户 界 面 的 基本 开发 方法 ,了 解 在 Android 界面 开 
发 过 程 中 常见 的 界面 控件 .界面 布局 菜单 和 界面 事件 的 使 用 方法 ,充分 理解 手机 应 用 程 
序 与 桌面 应 用 程序 在 用 户 界 面 开 发 上 的 异同 之 处 。 

本 章 学 习 目 标 : 

。 了 解 各 种 界面 控件 的 使 用 方法 ; 

。 掌握 各 种 界面 布局 的 特点 和 使 用 方法 ; 

。 掌握 选项 菜单 . 子 菜单 和 快捷 菜单 的 使 用 方法 ; 

。 掌握 操作 栏 和 Fragment 的 使 用 方法 ; 

。 掌握 按键 事件 和 触摸 事件 的 处 理 方法 。 


51 APREA 


用 户 界面 (User Interface,UI) 是 系统 和 用 户 之 间 进 行 信息 交换 的 媒介 ,实现 信息 的 
内 部 形式 与 人 类 可 以 接受 形式 之 间 的 转换 。 最 古老 的 用 户 界 面 是 各 种 形式 的 文字 、 图 
JE .旗帜 和 手势 等 ,这 些 抽象 符号 作为 信息 传递 的 介质 ,使 人 类 可 以 理解 这 些 信息 所 包含 
的 意义 或 指 代 的 实体 。 

算盘 是 由 柱子 组 成 的 最 早 的 人 机 交互 界面 。 在 计算 机 出 现 的 早期 , 批 处 理 界面 
(1945 一 1968 年 ) 和 命令 行 界面 (1969 一 1983 年 ) 得 到 广泛 的 使 用 。 目 前 ,流行 的 用 户 界 
面 是 图 形 用 户 界面 (Graphical User Interface. GUD) ,采用 图 像 的 方式 与 用 户 进行 交互 。 
与 早期 的 交互 界面 相 比 , 图 形 界面 对 于 用 户 来 说 更 加 简便 易 用 ,用 户 从 此 不 再 需要 记 住 
大 量 的 命令 ,取而代之 的 是 通过 窗口 .菜单 和 按钮 等 方式 来 进行 操作 。 未 来 的 用 户 界面 
将 更 多 地 运用 虚拟 现实 技术 ,使 用 户 能 够 摆脱 键盘 与 鼠标 的 交互 方式 ,而 通过 动作 、 语 
言 ,甚至 是 脑 电 波 来 控制 计算 机 。 当 然 ,对 用 户 界面 的 深入 探讨 远 超 出 了 本 书 的 涉及 范 
围 , 感 兴趣 的 读者 可 以 阅读 相关 方面 的 书籍 。 

在 手机 上 进行 用 户 界面 设计 是 一 项 具有 挑战 性 的 工作 。 首 先 ,手机 的 界面 设计 者 和 
程序 开发 者 是 独立 且 并 行 工作 的 ,这 就 需要 界面 设计 与 程序 逻辑 完全 分 离 , 不 仅 有 利于 
并 行 工作 ,而且 在 后 期 修改 界面 时 也 可 以 避免 修改 程序 的 逻辑 代码 ;其 次 ,不 同型 号 手机 
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的 屏幕 分 辩 率 .尺寸 和 长 宽 比 各 不 相同 ,程序 界面 需要 能 够 根据 屏幕 信息 ,自动 调整 界面 
控件 的 位 置 和 尺寸 ,避免 因为 屏幕 分 辩 率 .尺寸 或 纵横 比 的 变化 而 出 现 显 示 错 误 ; 最 后 ， 
手机 屏幕 尺寸 较 小 ,设计 者 必须 能 够 合理 利用 有 限 的 显示 空间 ,构造 出 符合 人 机 交互 规 
则 的 用 户 界面 ,避免 出 现 凌乱 拥挤 的 用 户 界面 。 

Android 系统 已 经 为 使 用 者 解决 了 界面 设计 的 前 两 个 问题 。 在 界面 设计 与 程序 逻辑 
分 离 方面 ,Android 程序 将 用 户 界 面 和 资源 从 多 辑 代码 中 分 离 出 来 ,使 用 XML 文件 对 用 
户 界面 进行 描述 ,资源 文件 独立 保存 在 资源 文件 夹 中 。Android 系统 的 用 户 界面 描述 非 
常 灵活 ,允许 模糊 定义 界面 元 素 的 位 置 和 尺寸 ,通过 声明 界面 元 素 的 相对 位 置 和 粗略 尺 
才 , 使 界面 元 素 能 够 根据 屏幕 尺寸 和 屏幕 摆 放 方式 动态 地 调整 显示 方式 。 

Android 用 户 界 面 框架 (Android UI Framework ) 采用 MVC (Model-View- 
Controller) 模 型 ,为 用 户 界面 提供 了 处 理 用 户 输 入 的 控制 器 (controller) 和 显示 图 像 的 视 
图 (view) ,模型 (model) 是 应 用 程序 的 核心 ,数据 和 代码 被 保存 在 模型 中 。 控 制 器 .视图 
和 模型 的 关系 如 图 5. 1 所 示 。 

MVC 模型 中 的 视图 将 应 用 程序 的 信息 反馈 给 用 户 , 可 能 的 反馈 方法 包括 视觉 ,听觉 或 
触觉 等 ,但 最 常用 的 就 是 通过 屏幕 显示 反馈 信息 。Android 系统 的 界面 元 素 以 一 种 树 型 结 
构 组 织 在 一 起 , 称 之 为 视图 树 (view tree) ,如 图 5. 2 所 示 。Android 系统 在 屏幕 上 绘制 界面 
元 素 时 ,会 依据 视图 树 的 结构 从 上 至 下 绘制 每 一 个 界面 元 素 。 每 个 元 素 负 责 对 自身 的 绘 
制 , 如 果 元 素 包 含 子 元 素 ,该 元 素 会 通知 其 下 的 所 有 子 元 素 进 行 绘制 。Android 系统 在 用 户 
界面 绘制 上 还 有 一 些 提高 效率 的 办 法 ,例如 ,如 果 父 元 素 能 够 确定 某 个 区 域 一 定 会 被 其 子 
元 素 绘制 , 则 父 元 素 会 停止 绘制 该 区 域 , 以 提高 屏幕 绘制 的 效率 ,缩短 绘制 时 间 。 


控制 器 ViewGroup 
[ 
View | | ViewGroup View 
绘制 界面 
模型 
View View View 
图 5.1 MVC 模 型 图 5.2 视图 树 


视图 树 由 View 和 ViewGroup 构成 。View 是 界面 中 最 基本 的 可 视 单 元 ,存储 了 屏 
幕 上 特定 矩形 区 域内 所 显示 内 容 的 数据 结构 ,并 能 够 实现 所 占据 区 域 的 界面 绘制 、 焦 点 
变化 .用 户 输入 和 界面 事件 处 理 等 功能 。View 也 是 一 个 重要 的 基 类 ,所 有 在 界面 上 的 可 
见 元 素 都 是 View 的 子 类 。ViewGroup 是 一 种 能 够 承载 多 个 View 的 显示 单元 ,一 般 有 
两 个 用 途 , 一 个 是 承载 界面 布局 , 另 一 个 是 承载 具有 原子 特性 的 重 构 模块 。 

MVC 模型 中 的 控制 器 能 够 接受 并 响应 程序 的 外 部 动作 ,如 按键 动作 或 触摸 屏幕 动 
作 等 。 控 制 器 使 用 队列 处 理 外 部 动作 ,每 个 外 部 动作 作为 一 个 独立 的 事件 被 加 入 队列 
中 ,然后 Android 用 户 界面 框架 按照 “先进 先 出 ”的 规则 从 队列 中 获取 事件 ,并 将 这 个 事 
件 分 配给 所 对 应 的 事件 处 理 函 数 。 
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Android 用 户 界 面 框架 中 的 另 一 个 重要 的 概念 就 是 单线 程 用 户 界面 (Single- 
threaded UI) 。 在 单线 程 用 户 界 面 中 ,控制 器 从 队列 中 获取 事件 ,视图 在 屏幕 上 绘制 用 户 
界面 ,使 用 的 都 是 同一 个 线程 。 单 线程 用 户 界 面 能 够 降低 应 用 程序 的 复杂 程度 ,同时 也 
能 减低 开发 的 难度 。 首 先 , 用 户 不 需要 在 控制 器 和 视图 之 间 进 行 同 步 。 其 次 ,所 有 事件 
处 理 完 全 按照 其 加 入 队列 的 顺序 进行 。 也 就 是 说 ,在 事件 处 理 函 数 返回 前 不 会 处 理 其 他 
事件 ,因此 用 户 界面 的 事件 处 理 函 数 具 有 原子 性 。 但 单线 程 用 户 界 面 也 有 它 的 缺点 ,如 
果 事 件 处 理 函 数 过 于 复杂 ,可 能 会 导致 用 户 界面 失去 响应 。 因 此 应 尽 可 能 在 事件 处 理 函 
数 中 使 用 简短 的 代码 ,或 将 复杂 的 工作 交 给 后 台 线程 处 理 。 
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Android 系统 的 界面 控件 分 为 定制 控件 和 系统 控件 。 定 制 控件 是 用 户 独 立 开发 的 控 
件 , 或 通过 继承 并 修改 系统 控件 后 所 产生 的 新 控件 ,能 够 提供 特殊 的 功能 和 显示 需求 。 
系统 控件 是 Android 系统 中 已 经 封装 的 界面 控件 ,是 应 用 程序 开发 过 程 中 最 常见 的 功能 
控件 。 系 统 控 件 更 有 利于 进行 快速 开发 ,同时 能 够 使 Android 应 用 程序 的 界面 保持 一 定 
的 一 致 性 。 

常见 的 系统 控件 包括 TextView、EditText、 Button、ImageButton、CheckBox、 
RadioButton, Spinner, List View 和 TabHost. 
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TextView 是 一 种 用 于 显示 字符 的 控件 ,EditText 
则 是 用 来 输入 和 编辑 字符 的 控件 ,因为 EditText 继承 


于 TextView, 所 以 EditText 是 一 个 具有 编辑 功能 的 m 
TextView 控件 。 Rajan 
TextViewDemo 示例 如 图 5. 3 所 示 , 从 上 至 下 分 
别 是 TextView01 和 EditText01。 在 XML 文件 中 
(/res/layout/main. xml) 中 的 代码 如 下 。 


[a TextViewDemo 


图 5.3 TextView 和 EditText 


< TextView android:id- "@ + id/TextView01" 
android:layout width- "wrap content" 
android:layout height- "wrap content" 
android:text- "TextView0l"» 

< /TextView> 

< EditText android:id- "8 + id/EditTextOl" 
android:layout width- "fill parent" 
android:layout height- "wrap content" 
android:text- "EditText0l"» 

10 </EditText> 


Dovwamoumwnb 2^ 
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第 1 fT8 android: id 属性 声明 了 TextView 的 ID, 这 个 ID 主要 用 于 在 代码 中 引用 
TextView 对 象 。“@ 十 id/TextView01” 表 示 所 设置 的 人 D 值 ,其 中 @ 表 示 后 面 的 字符 串 
是 ID 资源 ;加 号 (十 ) 表 示 需 要 建立 新 资源 名 称 ,并 添加 到 R. java 文件 中 ; 斜 杠 后 面 的 字 
符 串 (TextView01) 表 示 新 资源 的 名 称 。 如 果 不 是 新 添加 的 资源 ,或 属于 Android 框架 的 
资源 , 则 不 需要 使 用 加 号 ,但 必须 添加 Android 包 的 命名 空间 ,例如 android: id — " @ 
android :id/empty" 。 

第 2 行 的 android:layout. width 属性 用 来 设置 TextView 的 宽度 , wrap, content X 


示 TextView 的 宽度 只 要 能 够 包含 所 显示 的 字符 串 即 可 。 第 3 行 的 android: layout |. 


height 属性 用 来 设置 TextView 的 高 度 。 第 4 行 表 示 TextView 所 显示 的 字符 串 ,在 后 面 
将 通过 代码 更 改 TextView 的 显示 内 容 。 第 7 行 中 的 fill parent 表示 EditText 的 宽度 
将 等 于 父 控件 的 宽度 。 

TextViewDemo. java 文件 中 ,引用 XML 文件 中 建立 的 TextView 和 Edit Text J} E 
改 其 显示 内 容 。 为 了 能 够 使 程序 正常 运行 ,需要 在 代码 中 引入 android. widget. EditText 


和 android. widget. TextView。 


TextView textView- (TextView) findViewById (R.id.TextView0l); 
EditText editText- (EditText) findViesById (R. id.EditText0l) ; 
textView.setText ("用 户 名 : "); 

editText.setText ("Rajan"); 


XE 


第 1 行 的 findViewById() 函 数 能 够 通过 ID 引用 界面 上 的 任何 控件 ,只 要 该 控件 在 
XML 文件 中 定义 过 ID 即 可 。 第 3 行 的 setText O 函数 用 来 设置 TextView 所 显示 的 
内 容 。 
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引发 相应 的 事件 处 理 函 数 。 如 果 需 要 在 按钮 上 显示 
图 像 ,可 以 使 用 Android 系统 提供 的 ImageButton 控 T 
件 ,图 5. 4 是 ButtonDemo 示例 ,上 方 是 Button 控件 BEET 
下 方 是 ImageButton 控件 。 E 

ButtonDemo 示例 从 上 至 下 分 别 是 TextView01、 * 
Button01 和 ImageButton01。 在 XML X fft (/res/ 
layout/main. xml) 中 的 代码 如 下 。 


E ButtonDemo 
Hel 


图 5.4 Button 和 ImageButton 


1 «Button android:id- "@ + id/Button01" 

2 android:layout width- "wrap content" 
3 android:layout height- "wrap content" 
4 android:text- "Button01"> 

5 — «Button» 
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6 <JImgeButton android:id- "@+ idq/ImagsButton0l" 
7 android:layout width- "wrap content" 

8 android:layout height- "wrap content" 

9 < /ImageButton» 


XML 文件 中 定义 了 两 个 按钮 的 宽度 和 高 度 ,并 定义 了 Button 控件 所 显示 的 内 容 ， 


Ner 

Go Into 

Open in New Window 
Shog In 


各 ttShi fttr 


lil Cory 

RÈ Copy Qualified Nane 

Q reste 

K Delete 
Build Path 
Refactor 

des Import. 

tA Esport 


Assign Working Sets. 
Validate 

Bun As 

Debug As 

Taan 

Compare With 


Source 


Properties 


Restore from Local History. 


Clic 


Cole 
Delete 


tr14AL UShi £t Down 


ALUSM ECT 


AltEnter 


5.5 更 新 文件 


android. widget. ImageButton, 


但 没有 定义 ImageButton 所 显示 的 图 像 , 显 示 图 像 内 
容 在 后 面 的 代码 中 进行 定义 。 

Android 系统 支持 多 种 图 形 格式 ,如 png\ico ^j. 
本 例 中 的 ImageButton 所 使 用 的 是 png 格式 。 首 先 
在 /res 目录 下 建立 drawable 目录 ,然后 将 download 
.png 文件 复制 到 /res/drawable 文件 夹 下 ,在 /res H 
录 上 选择 Refresh( 如 图 5. 5 所 示 ), 刷 新 后 新 添加 的 
文件 将 显示 在 /res/drawable 文件 夹 下 ,同时 R. java 
文件 内 容 也 得 到 了 更 新 。 如 果 R. java 文件 不 更 新 ， 
则 无 法 在 代码 中 使 用 该 资源 ,会 出 现 无 法 找到 资源 的 
错误 提示 。 

在 ButtonDemo. java 文件 中 ,引用 XML 文件 建 
立 的 Button 和 ImageButton, 更改 Button. 显示 字符 
内 容 和 ImageButton 图 像 内 容 。 为 了 使 程序 正常 运 
行 ,需要 在 代码 中 引入 android. widget. Button 和 
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Button button- (Button) findViewById (R. id.Button01) ; 

InegeButton imegeButton- (IregeButtion) findViesByT R. id. ImegeBattonol) 
buttcn.setText ("Button fiz £l ") ; 

imageButton.setImageResouroe (R.drawable.download) ; 


第 1 行 和 第 2 行 代码 用 于 引用 在 XML 文件 中 定义 的 Button 控件 和 ImageButton 
控件 。 第 3 行 代码 将 Button 的 显示 内 容 更 改 为 “Button 按钮 >。 第 4 行 代码 利用 
setImageResource ( ) 函数 .将 新 加 入 的 png 文件 R. drawable. download 传递 给 


ImageButton 。 


为 了 能 够 使 按钮 响应 点 击 事件 ,需要 在 onCreate O 函数 中 为 Button. 控件 和 
ImageButton 控件 添加 点 击 事件 的 监听 器 ,其 代码 如 下 。 
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F 


final TextView textView- (TextView) findViewById (R.id.TextView01); 
button.setOnClickListener (new View.OnClickListener() ( 

public void onClick(View view) ( 
textView.setText ("Button fi £l ") ; 
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public void onClick(View view) ( 


6 

7 imageButton.setOnClickListener (new View.OnClickListener() ( 
8 

9 textView.setText ("ImageButton f £l ") ; 


在 第 2 行 代码 中 ,button 对 象 通 过 调用 setOnClickListener O 函数 ,注册 一 个 点 击 
(Click) 事 件 的 监听 器 View. OnClickListener()。 第 3 行 代 码 是 点 击 事件 的 回调 函数 。 
第 4 行 代码 将 TextView 的 显示 内 容 更 改 为 “Button 按钮 ”。 

View. OnClickListenerO Æ View 定义 的 点 击 事件 的 监听 器 接口 ,并 在 接口 中 仅 定 
X f onClick() 函 数 。 当 Button 从 Android 界面 框架 中 接收 到 事件 后 ,首先 检查 这 个 事 
件 是 否 是 点 击 事件 ,如 果 是 点 击 事件 ,同时 Button. 又 注册 了 监听 器 , 则 会 调用 该 监听 器 中 
的 onClick O PR C. 

每 个 View 仅 可 以 注册 一 个 点 击 事件 的 监听 器 ,如 果 使 用 setOnClickListener O 函数 
注册 第 二 个 点 击 事件 的 监听 器 ,之 前 注册 的 监听 器 将 被 自动 注销 。 给 每 个 按钮 注册 一 个 
点 击 事件 监听 器 ,每 个 按钮 的 事件 处 理 程序 都 在 各 自 的 onClick O PR ri 3oC FE fie 05 (d (XC 
码 更 加 清晰 、 易 读 , 且 易 于 维护 。 当 然 , 也 可 以 将 多 个 按钮 注册 到 同一 个 点 击 事件 的 监听 
器 上 ,示例 代码 如 下 : 


1 Button.OnclickListener buttonListener= new Button.OnClickListener(){ 
2 G Override 

3 public void onClick(View v) { 

4 switch(v.getId()) ( 

5 case R.id.Button0l: 

6 textView.setText ("Button {k £l ") ; 

T retum; 

8 case R.id. ImageButton0l: 

9 textView.setText ("ImageButton f fl ") ; 
10 return; 

u } 

12 H 

B button.setOonClickListener (buttonListener); 

14 imagsButton.setOnclickListener (buttonListener) ; 


第 1 行 至 第 12 行 代码 定义 了 一 个 名 为 buttonListener 的 点 击 事件 监听 器 ,第 13 f 
和 第 14 行 代码 分 别 将 该 监听 器 注册 到 Button 和 ImageButton 上 。 
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CheckBox 是 同时 可 以 选择 多 个 选项 的 控件 ,而 RadioButton 则 是 仅 可 以 选择 一 
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个 选项 的 控件 。RadioGroup 是 RadioButton 的 承载 体 ,程序 运行 时 不 可 见 , 应 用 程序 
中 可 能 包含 一 个 或 多 个 RadioGroup。RadioGroup 
包含 多 个 RadioButton ,在 一 个 RadioGroup 中 , 用 
户 仅 能 够 选择 其 中 一 个 RadioButton。 在 图 5. 6 

CheckBox01 中 ,RadioGroup 中 包含 两 个 RadioButton, 当选 择 
v^ CheckBox02 RadioButtonl 后 , RadioButton2 自动 变 为 非 选 择 


[a CheckboxRadiobuttonDemo 


RadioButton01 状态 。 

CheckboxRadiobuttonDemo 示例 如 图 5. 6 所 示 , 从 
上 至 下 分 别 是 TextView01、CheckBox01、CheckBox02、 
RadioButton01 和 RadioButton02。 在 XML 文件 (/res/ 


* RadioButton02 


图 5.6 CheckBox 和 RadioButton 


layout/main. xml) 中 的 代码 如 下 : 


1 < TextView android:id- "@ + id/TextViewOl" 

2 android:layout width- "fill parent" 

3 android:layout height= "wrap content" 
4 android:text- "@ string/hello"/» 

5 < CheckBox android:id- "@  id/CheckBox01" 

6 android:layout width- "wrap content" 
7 android:layout height- "wrap content" 
8 android:text- "CheckBox01"» 

9 


9 < /CheckBox> 

10  «CheckBox android:id- "Q + id/CheckBox02" 
ii android:layout_width= "wrap content" 
12 android:layout height- "wrap content" 
13 android:text- "CheckBox02"» 


14 </checkBox> 
15  «RadicGroup android:id- "@ + id/FadioGroupOl" 


16 android:layout width "wrap content" 

17 android:layout height= "wrap_content"> 

18 < FadicButton android:id- "8 + id/RadicButtonOl" 
19 android:layout width- "wrap content" 

20 android:layout height- "wrap content" 

21 android:text- "RadioButton0l"» 

22 < /RadicButton» 

23 < FadicButton android:id- "8 + id/RadicButton02" 
24 android:layout width- "wrap content" 

25 android:layout height- "wrap content" 

26 android:text- "RadioButton(?" 

21 < fRadicButton» 


28  «/RadioGroup» 


第 15 £1 RadioGroup- $5458] f —* RadioGroup ,在 第 18 行 和 第 23 行 分 别 声 
明了 两 个 RadioButton ,这 两 个 RadioButton 是 RadioGroup 的 子 元 素 。 
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在 代码 中 引用 CheckBox 和 RadioButton 的 方法 可 以 参考 下 面 的 代码 。 


1 
2 


CheckBox checkBoxl- (CheckBox) findViewById (R.id.CheckBox01) ; 
FadicButton radicButtonl- (FadicButtan) fincViewByTd (R. id.RadicButtonol) ; 


CheckBox 设置 点 击 事件 监听 器 的 方法 ,与 Button 中 介绍 的 方法 相似 ,唯一 区 别 在 
于 将 Button. OnClickListener 换 成 了 CheckBox. OnClickListener, 下 面 给 出 简要 代码 。 


1 
2 
3 
4 
5 
6 
1 


CheckBax.anclTickListener deckboListener- new CeckBox.ancdickListener () ( 
@ Override 
public void onClick (View v) ( 
// 过 程 代码 
uL 
checkBox1l.setOnClickListener (checkboxListener) ; 
checkBox2.setOnClickListener (checkboxListener) ; 


RadioButton 设置 点 击 事件 监听 器 的 方法 : 


1 
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-OnClickListener () ( 
@ Override 
public void onClick(View v) ( 
// 过 程 代码 
W: 
radicButtonl.setOnClickListener (radioButtonListener) ; 
radicButton?.setOnClickListener (radioButtonListener) ; 
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Spinner 是 从 多 个 选项 中 选择 一 个 选项 的 控件 ,类 似 于 桌面 程序 的 组 合 框 
(ComboBox) ,但 没有 组 合 框 的 下 拉 菜 单 ,而 是 使 用 浮动 菜单 为 用 户 提 供 选 择 。 

SpinnerDemo 示例 如 图 5. 7. 所 示 , 从 上 至 下 分 别 是 TextView01 和 Spinner01。 在 
XML 文件 (/res/layout/main. xml) 中 的 代码 如 下 。 
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«TextView  android:id- "@+ id/TextViewOl" 
android:layout width- "fill parent" 
android:layout height- "wrap content" 
android:text- "8 string/hello"/» 

< Spinner android:id- "@+ id/Spinner0l" 
android:layout width- "300dip" 
android:layout height- "wrap content" 

< /Spinner» 
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第 5 行使 用 二 Spinner 二 标签 声明 了 一 个 Spinner 控件 ,并 在 第 6 行 代码 中 指定 该 控 
件 的 宽度 为 300dip。 

在 SpinnerDemo. java 文件 中 ,定义 一 个 ArrayAdapter 适配器 ,在 ArrayAdapter 中 
添加 在 Spinner 中 可 以 选择 的 内 容 。 为 了 使 程序 能 够 正常 运行 ,需要 在 代码 中 引入 


android. widget. ArrayAdapter 和 android. widget. Spinner. 


Spinner spinner- (Spinner) fincViewById(R.id.Spinner01) ; 

List< String» list- new ArrayList« String» (); 

list .add("Spinner F 1"); 

list .add("Spinner F 2"); 

list .add("Spinner F 3"); 

ArrayMdapter« String» adapter- new ArrayAdapter« String» (this, 

android.R.layout.simple spinner item, list); 

3 adapter.setDropDownViewResource (android.R.layout.simple spinner _ 
dropdown item); 

8 Spinner.setAdapter (adapter) ; 
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第 2 行 代码 建立 了 一 个 字符 串 数组 列表 (ArrayList) ,这 种 数组 列表 可 以 根据 需要 进 
行 增 减 ,和 String 二 表示 数组 列表 中 保存 的 是 字符 串 类 型 的 数据 。 在 代码 的 第 3、 第 4f 
第 5 行 中 ,使 用 add() 函 数 分 别 向 数组 列表 中 添加 3 个 字符 串 。 第 6 行 代 码 建立 了 一 个 
ArrayAdapter 的 数组 适配器 ,数组 适配器 能 够 将 界面 控件 和 底层 数据 绑 定 在 一 起 。 在 这 
里 ArrayAdapter 将 Spinner 和 ArrayList 绑 定 在 一 起 ,所 有 ArrayList 中 的 数据 ,将 显示 
在 Spinner 的 浮动 菜单 中 , 绑 定 过 程 由 第 8 行 代 码 实现 。 第 7 行 代码 设 定 了 Spinner 浮动 
菜单 的 显示 方式 ,其 中 ,android. R. layout. simple spinner dropdown item 是 Android 系 
统 内 置 的 一 种 浮动 菜单 ,如 图 5. 7 所 示 。 如 果 将 其 改 为 android. R. layout. simple | 
spinner_item, 则 显示 效果 如 图 5. 8 所 示 。 


| | SpinnerDemo 


Hello World, SpinnerDemoActivity! 


Spinner 子 项 1 


E SpinnerDemo 


Spinner 子 项 1 i 1d. 


Si 项 1 
Spinner 子 项 2 pinner 子 项 

Spinner 子 项 1 
Spinner 子 项 2 


Spinner 子 项 3 
Spinner 子 项 3 


5.7 Spinner 图 5.8 Spinner 的 item 菜单 


为 了 保证 用 户 界面 显示 的 内 容 与 底层 数据 一 致 ,应 用 程序 需要 监视 底层 数据 的 变 
化 ,如 果 底 层 数据 更 改 了 , 则 用 户 界 面 也 需要 修改 显示 内 容 。 在 使 用 适配器 绑 定 界 面 控 
件 和 底层 数据 后 ,应 用 程序 就 不 需要 再 监视 底层 数据 的 变化 ,从 而 极 大 地 简化 了 代码 的 


525 LisMew 


ListView 是 用 于 垂直 显示 的 列表 控件 ,如 果 显 
示 内 容 过 多 , 则 会 出 现 垂直 滚动 条 。ListView 是 在 
界面 设计 中 经 常 使 用 的 界面 控件 ,其 原因 是 ListView 
能 够 通过 适配器 将 数据 和 显示 控件 绑 定 ,在 有 限 的 屏 
幕 上 提供 大 量 内 容 供用 户 选择 :而 且 支 持 点 击 事件 ， RR 
可 以 用 少量 的 代码 实现 复杂 的 选择 功能 。 ListView 子 项 2 

ListViewDemo 示例 如 图 5. 9 所 示 , 从 上 至 下 分 
别 是 TextViewOl 和 ListView01。 在 XML 文件 (/ 
res/layout/main. xml) 中 的 核心 代码 如 下 。 II SL9: aet Vie 


ListView 子 项 3 


1 <TextView  android:id- "8 + id/TextViewOl" 
2 android:layout width- "fill parent" 

3 android:layout beight- "wrap content" 
4 android:text- "8 string/hello"/» 

5 < ListView android:id- "@ + id/ListViewOl" 

6 android:layout width- "wrap content" 

7 android:layout beight- "wrap content" 
8 < /ListView> 


在 ListViewDemo. java 文件 中 ,首先 需要 为 ListView 创建 适配器 ,并 添加 ListView 
中 所 显示 的 内 容 。 


final TextView textView- (TextView)findViewById(R.id.TextView0l); 

ListView listView- (ListView)findViewById(R.id.LlistView0l); 

List< String> list- new ArrayList« String» (); 

list.add("ListView Fi 1"); 

list.add("ListView F 2"); 

list.add("ListView F 3"); 

ArrayAdapter« String» adapter- new ArrayZdapter« String» (this, 
android.R.layout.simple list item 1, list); 

8  listView.setAdapter (adapter) ; 
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第 2 行 代码 通过 ID 引用 了 XML 文件 中 声明 的 ListView, 58 3 行 至 第 6 行 声明 了 


数组 列表 。 第 7 行 声 明了 适配器 ArrayAdapter. 58 3 个 参数 list 说 明 适 配器 的 数据 源 为 
数组 列表 。 第 8 行将 ListView 和 适配器 绑 定 。 


下 面 的 代码 声明 了 ListView 子 项 的 点 击 事件 监听 器 ,用 以 判断 用 户 在 ListView 中 
选择 的 是 哪 一 个 子 项 。 
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1 AdapterView.OnTtemClickListener listViewListener- new 
AcapterView.OnItenClickListener () ( 
2 @ Override 
public void onItemClick (AdapterView< ?> arg0, View argl, int arg2， 
long arg3) ( 
4 String msg- " 父 View: "+ arg0.toString () "An" "F View: "r argl 
.tostring(0+ "\n"+ "位 置 : "+ String.valueOf (arg?) - ",ID: "+ String 
-valueof (arg3) ; 
5 textView.setText (msg) ; 
6 HW; 
p listView.setOnItemClickListener (listViewListener); 


第 1 行 的 AdapterView. OnItemClickListener 是 ListView 子 项 的 点 击 事件 监听 
器 ,同样 是 一 个 接口 ,需要 实现 onltemClick O PR Et. Æ ListView 子 项 被 选择 后 ， 
onItemClick O 函数 将 被 调用 。 第 3 行 的 onItemClick() 函数 中 一 共有 4 个 参数 ,参数 
1 表示 适配器 控件 ,这 里 就 是 ListView; 参 数 2 表示 适配器 内 部 的 控件 ,这 里 是 
ListView 中 的 子 项 ;参数 3 表示 适配器 内 部 的 控件 ,也 就 是 子 项 的 位 置 ; 参 数 4 表示 
子 项 的 行 号 。 第 4 行 和 第 5 行 代码 用 于 显示 ,选择 子 项 确定 后 ,在 TextView 中 
显示 子 项 父 控件 的 信息 、 子 控件 信息 、 位 置信 息 和 ID 信息 。 第 7 行 代码 是 ListView 
指定 刚 声明 的 监听 器 。 
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Tab 标签 页 是 界面 设计 中 经 常 使 用 的 界面 控件 ,可 以 实现 多 个 分 页 之 间 的 切换 ,每 
个 标签 页 可 以 显示 不 同 内 容 。 如 图 5. 10 是 Android 
系统 内 置 的 “拨号 界面 ,通过 标签 页 在 拨号 查看 记 
录 和 联系 人 功能 之 间 进 行 切换 。 

在 Android SDK 3.0 中 , 随 着 新 的 UI 设计 思想 
的 引入 ,android. app. Fragment 成 为 一 种 新 的 界面 设 
计 模 式 。Android SDK 4. 0 继承 了 3. 0 版 本 的 设计 
思路 , 因此 不 建议 开发 者 使 用 android. app 
.TabActivity, 而 使 用 新 出 现 的 Fragment 实现 Tab 
标签 页 。 但 因 旧 版 本 Android 系统 还 有 一 定 的 生存 
周期 ,上 且 使 用 TabActivity 实现 的 Tab 标签 页 的 方法 
在 Android SDK 4. 0 中 仍 可 以 正常 运行 ,所 以 本 书 仍 对 这 种 方法 进行 介绍 。 

这 里 以 TabDemo 为 例 , 说 明 如 何 设计 和 使 用 TabHost, TabDemo 示例 的 运行 结果 
如 图 5. 11 所 示 。 

Tab 标签 页 的 使 用 首先 要 设计 所 有 分 页 的 界面 布局 ,在 分 页 设计 完成 后 ,使 用 代码 
建立 Tab 标签 页 ,并 给 每 个 分 页 添加 标识 和 标题 ,最 后 确定 每 个 分 页 所 显示 的 界面 
布局 。 


5.10 TabHost 
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相对 布局 


5.11 TabDemo 示例 的 运行 结果 


在 设计 分 页 的 界面 布局 时 ,使 用 的 方法 与 设计 普通 用 户 界面 没有 什么 区 别 。 为 了 便 
于 可 视 化 和 编码 ,为 每 个 分 页 建立 一 个 XML 文件 ,用 以 编辑 和 保存 分 页 的 界面 布局 。 在 
TabDemo 示例 中 ,在 /res/layout 目录 下 建立 三 个 XML 文件 ,分 别 为 tabl. xml, tab2 
. xml 和 tab3. xml, 这 三 个 文件 分 别 使 用 线性 布局 .相对 布局 和 绝对 布局 实例 中 的 main 
. xml 代码 ,并 将 布局 的 ID 分 别 定 义 为 layout01、layout02 和 layout03。 下 面 分 别 给 出 
tabl. xml,tab2. xml 和 tab3. xml 文件 的 部 分 代码 。 

tabl. xml 文件 代码 : 


1 <?xml version- "1.0" encoding- "utf- 8"?» 
2 < Linearlayout android:id- "@ + id/layout01" 
3 
4 
5 < /Linearlayout^ 

tab2. xml 文件 代码 : 


<?xml version- "1.0" encoding- "utf- 8"?» 
< BbsoluteLayout android:id- "8 + id/layout02" 


tab3. xml 文件 代码 : 


<?xml version- "1.0" encoding- "utf- 8"?» 
< Felativelayout android:id- "8 + id/layout03" 
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< /Felativelayout^? 


86 Mos na aom) 


分 页 的 布局 代码 设计 完成 后 ,在 TabDemoActivity. java 文件 中 键入 下 面 的 代码 , 创 
建 Tab 标签 页 ,并 建立 子 页 与 界面 布局 直接 的 关联 关系 。 


1 package edu.hrbeu.Tabpempy 
3 import android.app.TabActivity; 
4  ámport android.os.Bundle; 
5 inport android.widget.TabHost; 
6 import android.view.LayoutInflater; 
7  8Supressiamings ("deprecation") 
8  püblic class TabDemoActivity extends TabActivity ( 
9 @ Override 
10 public void onCreate (Bundle savedInstanceState) { 
11 Super.onCreate (savedInstanceState) ; 
2 TabHost tabHost- getTabHost () ; 
13 Layout Inflater. fram(this) .inflate(R.layout.tabl, 
tabHost..getTabContentView () true) 
14 Layout Inflater. fram(this) .inflate(R.layout.tab?, 
tabHost .getTabContentView () , true) ; 
15 layoutInflater.from(this) .inflate(R.layout.tab3, 
tabHost .getTabContentView () , true) ; 
16 tabHost .ackiTab (tabHost .newTabSpec ("TAB1") 
17 .setIndicator ("X f'E ffi Je] ") .setContent (R.id.layout01) ) ; 
18 tabHost .ackiTab (tabHost .newTabSpec ("TAEO") 
19 .setIndicator ("ff X4 fii Jj ") -setContent (R. id.layout02)); 
20 tabHost .ackiTab (tabHost .newTabSpec ("TAB3") 
21 .setIndicator ("fH X} ffi JF) ") .setContent (R. id. layout03)) ; 
22 } 
23 } 


第 7 行 代码 是 避免 编译 器 出 现 警告 信息 。 因 为 TabActivity 已 经 过 期 ,强制 使 用 会 
出 现 大 量 的 警告 信息 ,这 里 使 用 @SuppressWarnings("deprecation") 可 以 将 因 API 过 期 
所 产生 的 警告 信息 屏蔽 。 

第 8 行 代码 的 声明 TabDemoActivity 类 继承 TabActivity. 与 以 往 继承 Activity 不 
同 ,TabActivity LARZA Activity 或 View。 第 12 行 代码 通过 getTabHost O 函数 
获得 了 Tab 标签 页 的 容器 ,用 以 承载 可 以 点 击 的 Tab 标签 和 分 页 的 界面 布局 。 第 13 行 代 
码 通过 LayoutInflater 将 tabl. xml 文件 中 的 布局 转换 为 Tab 标签 页 可 以 使 用 的 View 对 象 。 
第 16 行 代码 使 用 addTab O 函数 添加 了 第 1 个 分 页 ,tabHost newTabSpec ("TAB1") 表 明 在 
第 12 行 代码 中 建立 的 tabHost 上 ,添加 一 个 标识 为 TABI 的 Tab 分 页 。 第 17 行 代码 使 
用 setIndicator O PR Zt E 4E 4) Vi t zi B bro. fii FH] setContent O 函数 设 定 分 页 所 关联 的 界 
面 布局 。 


在 实现 Tab 标签 页 时 ,除了 可 以 将 多 个 Tab 分 页 
放置 在 同一 个 Activity 中 ,还 可 以 将 不 同 Tab 分 页 加 
载 到 不 同 的 Activity 上 。 两 种 方式 在 界面 显示 上 是 
没有 区 别 的 ,但 笔者 建议 使 用 后 一 种 方式 处 理 
Tab 分 页 和 Activity 之 间 的 关系 ,每 个 Tab 分 页 对 应 
一 个 Activity, 有 利于 用 户 对 界面 控件 的 管理 和 控制 。 

TabDemo2 示例 说 明 如 何 将 不 同 的 Activity 显示 
在 不 同 的 Tab 分 页 上 。TabDemo2 示例 与 TabDemo 
示例 的 用 户 界 面 是 完全 相同 的 ,所 以 界面 可 以 参考 
FK 5.11. 

从 图 5. 12 可 以 发 现 ,与 TabDemol 示例 相 比 ， 
TabDemo2 示例 的 布局 目录 (/res/layout) 中 多 了 一 个 
main. xml 文件 ,代码 目录 中 增加 了 TablActivity 
. java, Tab2Activity. java 和 Tab3Activity. java 三 个 
xt. 

首先 给 出 TablActivity. java 文件 的 全 部 代码 : 
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(e$ TabDemo2 
Bsr 
E edu.hrbeu.TabDemo2 
国 TablActivityjava 
Tab2Activityjava 
Tab3Activityjava 
国 TabDemoZActivity java. 
£9 gen [Generated Java Files] 


© drawable-hdpi 
© drawable-Idpi 
© drawable-mdpi 
& layout 
R mainxml 
tablxml 
tab2xml 
tab3.xml 
© values 
B AndroidManifestxml 
国 proguard.cfg 
project.properties 


图 5.12 TabDemo2 示例 文件 结构 


1 package edu.hrbeu.TabDero?; 

2 

3 import android.app.Activity; 

4 import android.os.Bundle; 

5 

6  püblic class TablActivity extends Activity( 

1 

8 @ Override 

9 public void onCreate (Bundle savedInstanceState) { 
10 Super.onCreate (savedInstanceState) ; 
u setContentView (R.layout.tabl); 

12 ) 

B } 


代码 的 第 11 行将 布局 目录 中 tabl. xml 文件 中 的 布局 加 载 到 Tabl Activity 


TablActivity. java, Tab2Activity. java 和 Tab3Activity. java 的 作用 完全 相同 ,分 别 


将 tabl. xml\tab2. xml 和 tab3. xml 加 载 到 三 个 不 同 的 Activity. 
下 面 分 析 TabDemo2Activity. java 文件 ,完整 代码 为 : 


package edu.hrbeu. TabDem?2; 


import android.content. Intent; 


1 
2 
3 import android.app.TabActivity; 
4 
5 inport android.os.Bundle; 
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6 import android.widget.TabHost; 

7 

8 @ SuppressWamings ("deprecation") 

9 piblic class TacDemo2Activity extends Tabhctivity { 

10 G Override 

nu public void onCreate (Bundle savedInstanceState) ( 

12 Super.onCreate (savedInstanceState) ; 

3 setContentView (R. layout main) ; 

14 

15 TabHost tabHost- getTabHost () ; 

16 

17 taHost.acHTsb (taciost .newTaibSpec ("AB1") .setIndicator (X tE ffi Jj ") .setContent (new Intent. 
() .setClass (this, TibIActivity.class))); 

18 taiHost .actIT3b (taicHost.newIaibSpec ("TAB2") .setIndicator ("4 X} d] JF) ") .setContent (new Intent 
() .setClass (this, Tib?2ctivity.class))); 

19 taiHost .actITsb (tabHbst.newIabSpec ("T8B3") .sestIndicator(" 相 对 布局 由 .setcontent (new Intent 
() .setClass (this, Tib3Activity.class))) ; 

20 ) 

2) 


代码 第 9 行 声明 TabDemo2Activity 继承 TabActivity 类 。 在 TabDemo 示例 中 , 代 
13575 17 行 的 setContent O 函数 的 参数 是 布局 文件 ,而 TabDemo2 示例 的 setClass() 的 参 
数 是 Intent. 通过 Intent 启动 TablActivity。 这 里 就 是 两 个 示例 的 明显 不 同 之 处 ， 
TabDemo2 示例 为 每 个 Tab 分 页 指定 了 不 同 的 Activity。 第 13 行 代码 声明 了 
TabDemo2Activity 的 布局 文件 main. xml, 下 面 给 出 这 个 布局 文件 的 完整 代码 。 


1 <?xml version- "1.0" encoding- "utf- 8"?> 

2  <Tabost xmins:android- "http: //schemas.android.con/apk/res/android" 
3 android:id- "6 android:id/tabhost" 

4 android:layout width- "fill parent" 

5 android:layout height= "fill parent"> 

6 < Linearlayout 

7 android:orientation- "vertical" 

8 android:layout width- "fill parent" 

9 android:layout height- "fill parent" 

10 android:padding- "5dp"> 

n < Tabiidget 

2 android:id- "6 android:id/tabs" 

B android: layout width= "fill parent" 

14 android:layout height- "wrap content"/» 
15 < FrameLayout 


16 android:id- "8 android:id/tabcontent" 
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17 android:layout width= "fill parent' 
18 android:layout height- "fill parent" 
19 android:pacding- "3dp"/> 

20 < /Linearlayout^ 

21  «/TabHost^ 


作为 TabActivity 的 布局 ,必须 以 TabHost 为 根 元 素 ( 代 码 第 2 行 ), 同 时 包含 
TabWidget 元 素 ( 代 码 第 1 行 ) 和 FrameLayout 元 素 ( 代 码 第 15 行 )。TabWidget 承载 
Tab 导航 栏 ,FrameLayonut 承载 Tab 页 的 内 容 , 现 在 FrameLayout 是 空 的 ,在 程序 运行 
时 ,TabHost 会 自动 使 用 Activity 填充 FrameLayout。 因 为 TabWidget 和 FrameLayout 
需要 垂直 地 并 列 排 布 ,因此 使 用 线性 布局 (代码 第 6 行 )。 

最 后 ,在 AnroidManifest. xml 文件 中 添加 三 个 新 建 Activity 的 声明 : 


<activity android:name- ".TablActivity"/^ 
«activity android:name- ".Tab?Activity"/^ 
«activity android:name- ".Tab3Activity"/^ 
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界面 布局 (layout) 是 用 户 界面 结构 的 描述 ,定义 界面 中 所 有 的 元 素 、 结 构 和 相互 关 
系 。 一 般 声明 Android 程序 的 界面 布局 有 两 种 方法 ,第 一 种 是 使 用 XML 文件 描述 界面 
布局 ; 另 一 种 是 在 程序 运行 时 动态 添加 或 修改 界面 布局 。 

Android 系统 在 声明 界面 布局 上 提供 了 很 好 的 灵活 性 ,用 户 既 可 以 独立 使 用 任何 一 
种 声明 界面 布局 的 方式 ,也 可 以 同时 使 用 两 种 方式 。 一 般 情 况 下 ,使 用 XML 文件 来 描述 
用 户 界面 中 的 基本 元 素 , 而 在 代码 中 动态 修改 需要 更 新 状态 的 界面 元 素 。 当 然 , 用 户 也 
可 以 将 所 有 的 界面 元 素 ,无 论 在 程序 运行 后 是 否 需要 修改 其 内 容 , 都 放 在 代码 中 进行 定 
义 和 声 明 。 很 明显 这 不 是 一 种 良好 的 界面 设计 模式 ,会 给 后 期 界面 修改 带 来 不 必要 的 麻 
烦 , 而 且 界 面 元 素 较 多 时 ,程序 的 代码 也 会 显得 凌乱 不 堪 。 

使 用 XML 文件 声明 界面 布局 ,能 够 更 好 地 将 程序 的 表现 层 和 控制 层 分 离 ,在 修改 
界面 时 将 不 再 需要 更 改 程序 的 源 代 码 。 例 如 ,在 程序 开发 完成 后 ,为 了 让 程序 能 够 支 
持 不 同 屏幕 尺寸 ,规格 和 语言 的 手机 , 则 可 以 声明 多 个 XML 布局 ,而 无 须 修改 程序 代 
码 。 不 仅 如 此 ,使 用 XML 文件 声明 的 界面 布局 ,用 户 还 能 够 通过 可 视 化 工具 直接 看 到 
所 设计 的 用 户 界 面 ,有 利于 加 快 界面 设计 的 过 程 ,并 且 为 界面 设计 与 开发 带 来 极 大 的 
便利 性 。 


531 线性 布局 


线性 布局 (LinearLayout) 是 一 种 重要 的 界面 布局 ,也 是 经 常 使 用 的 界面 布局 。 在 线 
性 布局 中 ,所 有 的 子 元 素 都 在 垂直 或 水 平方 向 按照 顺序 在 界面 上 排列 。 如 果 垂 直 排 列 ， 
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则 每 行 仅 包含 一 个 界面 元 素 ;同样 ,如 果 水 平 排列 , 则 每 列 仅 包含 一 个 界面 元 素 。 图 5. 13 
分 别 是 垂直 排列 的 线性 布局 和 水 平 排列 的 线性 布局 的 示例 。 


E LinearLayout B LinearLayout 


用 户 名 确认 BUB 


图 5.13 垂直 排列 和 水 平 排列 的 线性 布局 


下 面 将 用 一 个 简单 的 示例 说 明 如 何 使 用 线性 布局 ,示例 的 目标 是 实现 图 5. 13( 左 图 ) 
所 显示 的 用 户 界 面 , 并 对 示例 中 用 到 的 界面 控件 进行 简单 的 介绍 。 

首先 创建 Android 工程 ,工程 名 称 是 LinearLayout, 包 名 称 是 edu. hrbeu 
.LinearLayout, Activity 名 称 为 LinearLayoutActivity。 为 了 能 够 完整 体验 创建 线性 布 
局 的 过 程 ,这 里 首先 删除 Eclipse 自动 建立 的 /res/layout/main. xml 文件 ,然后 建立 垂直 
排列 的 线性 布局 XML 文件 。 右 击 /res/layonut 文件 夹 ,选择 New Other.. — Android 
XML File, 打 开 XML 文件 建立 向 导 ,建立 的 命名 为 main. vertical. xml 的 XML 文件 ,类 
型 为 Layout, 不 需要 修改 资源 配置 ,保存 位 置 为 /res/layout. XML 文件 的 根 节点 元 素 选 
择 为 线性 布局 (LinearLayout) ,如 图 5. 14 所 示 。 


4B New Android XML File ` » L hs 


New Android XML File 
Creates a new Android XML file 


| Project UnearLayout 
Fle ^ main verticalxml 


| What type of resource would you like to create? 


Layout Values Drawable Menu 
© Color list Animator Animation D AppWidget Provider 
Preference Searchable 


| What type of resource configuration would you like? 


Available Qualifiers < Chosen Qualifiers 
4 Country Code a 
tË Region 

s "rm 


| Folder /res/layout 


| Select the root element for the XML file: 


[me 


| © sBade | Ner Finish Camel ) 


图 5.14 界面 可 视 化 编辑 器 


用 户 界面 
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双击 新 建立 的 /res/layout/main_vertical. xml 文件 ,Eclipse 将 自动 打开 界面 可 视 化 


编辑 器 ,如 图 5. 15 所 示 。 可 视 化 编辑 器 顶部 是 配置 清单 ,可 以 选择 不 同 的 


屏幕 尺寸 、 屏 


幕 方向 和 SDK 版 本 等 。 下 部 左 侧 是 界面 布局 和 界面 控件 ,用 户 可 以 将 需要 的 布局 和 控 


件 拖 电 到 右边 的 可 视 化 界面 中 ,并 修改 布局 和 控件 的 属性 。 右 侧 是 可 视 化 
能 够 实时 地 呈现 用 户 界 面 。 左 下 角 的 Graphical Layout 标签 和 main. verti 
能 够 在 可 视 化 编辑 器 和 XML 文件 编辑 器 之 间 切 换 。 


的 用 户 界面 ， 


cal. xml 标签 


Editing config: default Any locale. v] Android Create..] 
3a7in WVGA (Nexus One) "|porrait “| Normal ~ [Day time |Theme ~ 
Palette. ”| nð Ba QAQIQA 


Form Widgets 


Text Fields 
Layouts 
Composite 
Images & Media 
Time & Date 
Transitions 
Advanced 
Other 
Custom & Library Views 


E Graphical Layout) (E main-verticalami 


5.15 界面 可 视 化 编辑 器 


在 Eclipse 右边 的 Outline 中 ,双击 LinearLayout, 打 开 线 性 布局 的 属性 编辑 器 。 线 
性 布局 的 排列 方法 由 Orientation 属性 控制 ,vertical 表示 垂直 排列 ,horizontal 表示 水 平 
排列 。 这 里 Orientation 属性 的 值 选择 vertical, 如 图 5. 16 所 示 , 表 示 该 线性 布局 为 垂直 
HEP), SAULT. Layout height 的 值 为 wrap_content, 表 示 线 性 布局 高 度 等 于 所 有 子 
控件 的 高 度 总 和 ,也 就 是 线性 布局 的 高 度 会 刚好 将 所 有 子 控件 包含 其 中 。 将 Layout 
width 属性 的 值 改 为 fill_parent, 表 示 线 性 布局 宽度 等 于 父 控件 的 宽度 ,就 是 将 线性 布局 


在 横向 上 占据 父 控件 的 所 有 空间 。 


Property 
Next focus left 
Next focus right 
Next focus up 
Ürientation vertical 


Paddine 
Padding bottom vertical 
Padding left 

Padding right 


5.16 修改 线性 布局 的 Orientation 属性 


打开 XML 文件 编辑 器 ,main_vertical. xml 文件 的 代码 如 下 。 
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1 <?xml version- "1.0" encoding- "utf- 8"?> 

2  «linearlayout 

3 xmlns:android- "http: //schemas .android.ox/apk/res/android" 
4 android:layout width- "fill parent" 

5 android:layout height- "wrap content" 

6 android:orientation- "vertical"» 

H 


< /LinearTayout> 


第 2 行 代码 是 声明 XML 文件 的 根 元 素 为 线性 布局 ,第 4、5、6 TARI Je TE R KE i dE 
器 中 修改 过 的 宽度 ,高度 和 排列 方式 的 属性 。 可 见 ,用 户 在 可 视 化 编辑 器 和 属性 编辑 器 
中 的 任何 修改 都 会 反映 在 XML 文件 中 ;反之 ,用 户 在 XML 文件 的 修改 也 会 影响 可 视 化 
编辑 器 和 属性 编辑 器 的 内 容 。 

然后 ,用 户 按 照 TextView, Edit Text, Button, Button 的 顺序 ,将 4 个 界面 控件 先后 
拖 蝶 到 可 视 化 编辑 器 中 ,所 有 控件 会 按照 拖 忠 的 顺序 显示 在 可 视 化 编辑 器 中 ,如 图 5. 17 
所 示 。 所 有 控件 都 自动 获取 控件 名 称 ,虽然 在 可 视 化 编辑 器 中 两 个 按钮 显示 的 都 是 
Button, 但 它们 分 别 被 命名 为 Buttoni 和 Button2。 


Palette ”| 四国 | (esf) 


Form Widgets 


Large Medium 


Text Fields 
Layouts 
Composite 


5.17 修改 线性 布局 的 Orientation 属性 


将 界面 控件 位 置 确 定 后 ,按照 表 5. 1 所 示 在 属性 编辑 器 中 修改 界面 控件 的 属 
性 。 从 表 5. 1 中 可 以 发 现 , 所 有 界面 控件 都 有 一 个 共同 的 属性 ID. ID 是 一 个 字符 
串 ,编译 时 被 转换 为 整数 ,在 代码 中 用 来 引用 界面 元 素 ,一 般 只 有 代码 中 需要 动态 修 
改 的 界面 元 素 才 设置 ID, 反 之 则 不 需要 设置 ID。 本 例 中 没有 在 代码 中 引用 任何 界 
面 元 素 , 因 此 完全 可 以 不 必 设置 ID, 但 为 了 说 明 ID 的 用 途 和 使 用 方法 ,在 本 例 中 为 
所 有 的 界面 控件 设置 了 ID。 


Os Arcrcid 用 户 界 面 
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表 5.1 线性 布局 界面 控件 的 属性 设置 


编 号 类 型 属 性 值 

Id @ + id/label 
1 TextView 

Text 用 户 名 : 

Id @ +id/entry 
2 EditText Layout width fill_parent 

Text [null] 

Id @ +id/ok 
3 Button 

Text 确认 

Id @ -- id/cancel 
4 Button 

Text 取消 


打开 XML 文件 编辑 器 ,查看 main. vertical. xml 文件 代码 ,发 现在 属性 编辑 器 内 填 
入 的 内 容 已 经 正确 写 人 了 XML 文件 ,此 时 main. vertical. xml 文件 的 全 部 代码 如 下 。 


<?xml version- "1.0" encoding- "utf- 8"?> 


< Linearlayout 


axmins:android- "http://schemas.android.com/apk/res/android" 


android:layout width= "fill parent" 
android:layout height- "wrap content" 
android:orientation- "vertical" 


< TextView android:id- "@ + id/label" 
android:layout width- "wrap content" 
android:layout height= "wrap content" 
android:text- "用 户 名 :> 

< /TextView> 

< EditText android:id- "Q + id/entry" 
android:layout height= "wrap content" 
android:layout width- "fill parent» 

< /EditText> 

< Button android:id- "@ + id/ok" 
android:layout width- "wrap content" 
android:layout height- "wrap content" 
android:text- "if A "> 

< /Button> 

< Button android:id- "8 + id/canoel" 
android:layout width- "wrap content" 
android:layout height- "wrap content" 
android:text- "取消 "> 

< /Button> 


< /LinearTayout> 
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最 后 ,将 LinearLayout. java 文件 中 的 setContentView CR. layout. main) 更改 为 
setContentView(R. layout. main_vertical) 。 运 行 后 的 结果 如 图 5.13( 左 ) 所 示 。 

建立 横向 排列 的 线性 布局 过 程 与 上 述 的 纵向 线性 布局 非常 相似 ,注意 以 下 几 个 关 

* 建立 main_horizontal. xml 文件 ; 

。 将 线性 布局 的 Orientation 属性 的 值 设置 为 horizontal; 

。 将 EditText 的 Layout width 属性 的 值 设置 为 wrap. content; 

* 将 LinearLayout. java 文件 中 的 setContentView (R. layout. main, vertical) 修改 


为 setContentView(R. layout. main horizontal) 。 
532 框架 布局 


框架 布局 (FrameLayout) 是 最 简单 的 界面 布局 ,用 来 存放 一 个 元 素 的 空白 空间 , 且 子 
元 素 的 位 置 是 不 能 够 指定 的 ,只 能 够 放置 在 空白 空间 的 左上 角 。 如 果 有 多 个 子 元 素 , 后 
放置 的 子 元 素 将 遮挡 先 放置 的 子 元 素 。 

为 了 更 好 地 理解 框架 布局 ,这 里 使 用 Android SDK 中 提供 的 层级 观察 器 (Hierarchy 
Viewer) 进 一 步 分 析 界 面 布局 。 层 级 观察 器 能 够 对 用 户 界面 进行 分 析 和 调试 ,并 以 图 形 
化 的 方式 展示 树 型 结构 的 界面 布局 。 另 外 , 它 还 提供 了 一 个 精确 的 像素 观察 器 (Pixel 
Perfect View) ,以 栅 格 的 方式 详细 观察 放大 后 的 界面 。 

在 模拟 器 上 运行 5. 3. 1 节 中 垂直 排列 的 线性 布局 示例 ,在 层级 观察 器 中 获得 示例 界 
面 布局 的 树 型 结构 图 ,如 图 5. 18 所 示 o 


LinearLayout 
#0@43599ee0 
NO ID 


FrameLayout FrameLayout 
#1@4359b858 #0@4359a730 
id/content NO ID 
LinearLayout TextView 
#0@4359bd60 #0@4359ad18 
NO ID id/title 


TextView EditText Button Button 
#0@4359bfa8 | | 41624359c5f8 | | 42(74359d5d8 | | #3@4359de18 
id/label id/entry id/ok id/cancel 


5.18 界面 布局 的 树 型 结构 图 
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结合 界面 布局 的 树 型 结构 图 (图 5. 180 和 示意 图 (图 5. 190 ,分 析 不 同 界面 布局 和 界 
面 控件 的 区 域 边界 。 用 户 界 面 的 根 节点 (#0@ 
43599ee0) 是 线性 布局 ,其 边界 是 整个 界面 ,也 就 区 域 1 
是 示意 图 的 最 外 层 的 实心 线 。 根 节点 右 侧 的 子 ”| 区 域 2 区 域 6 
节点 (#0@43599a730) 是 框架 布局 , 仅 有 一 个 节 KR 
点 元 素 (# 0 @ 4359ad18), 这 个 子 元 素 是 | [ 
TextView 控件 ,用 来 显示 Android 应 用 程序 名 
称 , 其 边界 是 示意 图 中 的 区 域 1。 因 此 框架 布局 “| 区 域 5 
元 素 #0@43599a730 的 边界 的 高 度 与 区 域 1 的 
高 度 相 同 ,宽度 充满 整个 根 节 点 的 区 域 。 这 两 个 
界面 元 素 是 系统 自动 生成 的 ,一般 情况 下 用 户 不 
能 够 修改 和 编辑 。 

根 节点 左 侧 的 子 节点 (#1@4359b858) 也 是 
框架 布局 ,边界 是 区 域 2 到 区 域 7 的 全 部 空间 。 
其 下 仅 有 的 一 个 子 节点 (#0@4359bd60) 元 素 是 
线性 布局 ,因为 线性 布局 的 Layout width 属性 
设置 为 fill_parent,Layout height 属性 设置 为 wrap_content, 因 此 该 线性 布局 的 宽度 就 是 
其 父 节点 #1@4359b858 的 宽度 ,高 度 等 于 所 有 子 节点 元 素 的 高 度 之 和 。 线 性 布局 #0@ 
4359bd60 的 4 个 子 节点 元 素 #0@4359bfa8、#1@4359c5f8、# 2@4359d5d8 和 #3@ 
4359de18 的 边界 ,分 别 是 界面 布局 示意 图 中 的 区 域 2、 区 域 3、 区 域 4 和 区 域 5。 


533 表格 布局 


表格 布局 (TableLayout) 也 是 一 种 常用 的 界面 布局 , 它 将 屏幕 划分 为 表格 ,通过 指定 
行 和 列 可 以 将 界面 元 素 添 加 到 表格 中 。 对 比 网 格 布局 的 示意 图 (图 5. 20) 和 效果 图 
(图 5.21) ,可 以 发 现 网 格 的 边界 对 用 户 是 不 可 见 的 。 表 格 布局 还 支持 嵌 套 ,可 以 将 另 一 
个 表格 布局 放置 在 前 一 个 表格 布局 的 网 格 中 ,也 可 以 在 表格 布局 中 添加 其 他 界面 布局 ， 
例如 线性 布局 、 相 对 布局 等 。 

参照 5. 3. 2 节 的 界面 示例 ,这 里 使 用 表格 布局 实现 用 户 界 面 。 建 立 一 个 新 的 
Android 工程 ,工程 名 称 为 TableLayout, 在 /res/layout/main. xml 文件 中 设计 基于 表格 
布局 的 用 户 界面 。 在 表格 布局 中 设计 一 个 2X2 的 网 格 , 每 个 网 格 中 放置 一 个 界面 控件 ， 
实现 效果 如 图 5. 21 所 示 。 


Taview | EditText 
Row! Le | E TableLayout 
Row2 Button Button 


表格 布局 


区 域 7 


5.19 界面 布局 的 示意 图 


图 5.20 表格 布局 的 示意 图 图 5.21 表格 布局 的 效果 图 
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(ATT 


建立 表格 布局 的 示例 并 不 困难 ,参照 5. 3. 2 节 的 示例 可 以 很 容易 地 实现 ,但 要 注意 
以 下 几 点 。 

(1) 向 界面 中 添加 一 个 表格 布局 ,无 须 修改 布局 的 属性 值 。 其 中 , Id 属性 为 
TableLayout01,Layout width 和 Layout height 属性 都 为 wrap_content。 

(2) 在 Outline 视图 中 ,在 TableLayout01 上 布 击 ,选择 Add Row 向 TableLayout01 
中 添加 两 个 TableRow。TableRow 代表 一 个 单独 的 行 ,每 行 被 划分 为 几 个 小 的 单元 , 单 
元 中 可 以 添加 一 个 界面 控件 。 其 中 ,Id 属性 分 别 为 TableRow01 和 TableRow02,Layout 
width 和 Layout height 属性 都 为 wrap _ 


El Task List (BE Outline 73 LBdini-] 
content, H TableLayouto1 
(3) 在 界面 可 视 化 编辑 器 上 ,向 TableRow01 Lips 
中 拖 虹 Text View 和 Edit Text 。 = entry (EditText) 
» H TableRowo2 
(4) 在 界面 可 视 化 编辑 器 上 ,再 向 Table- E ok (Button) - "Bei." 


区 Button02 - "Roi 


Row02 中 拖 电 两 个 Button, 效 果 如 图 5. 22 
所 示 。 
(5) 参考 表 5.2 设置 TableRow 中 4 个 界 


图 5.22 Outline 视图 中 的 表格 布局 


面 控件 的 属性 值 。 
表 5.2 表格 布局 界面 控件 的 属性 设置 
编 号 类 型 属 性 值 

Id @ 4- id/label 
Text 用 户 名 : 

g TextView Gravity right 
Padding 3dip 
Layout width 160dip 
Id (à +id/entry 
Text [null] 

2 EditText 
Padding 3dip 
Layout width 160dip 
ld @@ 十 id/ok 

3 Button Text 确认 
Padding 3dip 
Id @ -- id/cancel 

4 Button Text 取消 
Padding 3dip 


main. xml 文件 的 完整 代码 如 下 。 
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<?xml version "1.0" encoding- "utf- 8"2» 


< Tablelayout android: id- "8  id/TableLayoutOl" 
android:layout width- "fill parent" 
android:layout height- "fill parent" 
axmüns:android- "http: //schemas.android.ooan/apk/res/android"» 
< TableRow android:id- "@ + id/TableRowOl" 
android:layout width- "wrap content" 
android:layout height- "wrap content" 
< TextView android:id- "@+ id/label" 
android:layout height= "wrap content" 
android:layout width- "160dip" 
android:gravity- "right" 
android:text- "用 户 名 : " 
android:padding- "3dip"> 
< /TextView> 
< EditText android:id- "@ id/entry" 
android:layout height= "wrap content" 
android:layout width- "160dip" 
android:padding- "3dip"» 
< /EditText> 
< /TableFow» 
< TableRow android:id- "@ + id/TableRow02" 
android:layout width- "wrap content" 
android:layout height= "wrap content" 
< Button android:id- "@ + id/ok" 
android:layout height- "wrap content" 
android:padding- "3dip" 
android:text- "确认 "> 
< /Button> 
< Button android:id- "@ + id/Button02" 
android:layout width- "wrap content" 
android:layout height- "wrap content" 
android:padding- "3dip" 
android:text- "取消 "> 


第 3 行 代码 使 用 了 过 TableLayout 之 标签 声明 表格 布局 ;第 7 行 和 第 23 行 代码 声明 


了 两 个 TableRow 元 素 ,用 来 表示 布局 中 的 两 行 ;第 12 行 利用 宽度 属性 android: layout | 


widt 


h 将 TextView 元 素 的 宽度 指定 为 160dip; 第 13 行使 用 属性 android: gravity 将 
TextView 中 的 文字 对 齐 方 式 指定 为 右 对 齐 ; 第 15 行使 用 属性 android: padding 声明 
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TextView 元 素 与 其 他 元 素 的 间隔 距离 为 3dip。 
534 相对 布局 


相对 布局 (RelativeLayout) 是 一 种 非常 灵活 的 布局 方式 ,能 够 通过 指定 界面 元 素 与 
其 他 元 素 的 相对 位 置 关系 ,确定 界面 中 所 有 元 素 的 布局 位 置 。 相 对 布局 和 线性 布局 有 着 


共同 的 优点 ,能够 最 大 限度 保证 在 各 种 屏幕 类 型 的 手 
机 上 正确 显示 界面 布局 。 


| RelativeLayout 


图 5. 23 是 相对 布局 的 一 个 示例 ,下 面 先 用 文字 

对 界面 元 素 的 添加 顺序 和 相互 关系 进行 描述 。 首 先 

添加 TextView 控件 (“用户 名 ”), 相 对 布局 会 将 

TextView 控件 放置 在 屏幕 的 最 上 方 ;然后 添加 

图 5.23 相对 布局 EditText 控件 (输入 框 ), 并 声明 该 控件 的 位 置 在 

TextView 控件 的 下 方 ,相对 布局 会 根据 TextView 

的 位 置 确定 EditText 控件 的 位 置 ;之 后 添加 第 一 个 Button 控件 (* 取 消 ” 按 钮 ) ,声明 在 

Edit Text 控件 的 下 方 , 且 在 父 控件 的 最 右边 ;最 后 ,添加 第 二 个 Button 控件 (“确认 ” 按 

HL) ,声明 该 控件 在 第 一 个 Button 控件 的 左 方 , 且 与 第 一 个 Button 控件 处 于 相同 的 水 平 

位 置 。 

main. xml 文件 的 完整 代码 如 下 。 


< ?xml version- "1.0" encoding- "utf- 8"?> 


1 

2 

3 «Felativelayout android:id- "@+ id/RelativelayoutOl" 

4 android:layout width- "fill parent" 

5 android:layout beight- "fill parent" 

6 xmins:android- "http: //schemas .android.caw/apk/res/android"» 
7 < TextView android:id- "@ + id/label" 

8 android:layout height- "wrap content" 

9 android:layout width- "fill parent" 


10 android:text- "H P144 : "> 

1 < /TextView> 

i < EditText android:id- "@+ id/entry" 

3 android:layout height- "wrap content" 
14 android:layout width= "fill parent" 
15 android:layout below- "8 id/label"» 

16 < /EditText> 

0 < Button android: id- "Q + id/cancel" 

18 android:layout height- "wrap content" 
19 android:layout width- "wrap content" 
20 android:layout alignParentRight- "true" 


21 android:layout marginleft- "l0dip" 
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22 android:layout below- "@ id/entry" 

23 android:text- "取消 "> 

24 < /Button> 

25 < Button android:id= "@ + id/ok" 

26 android:layout height= "wrap content" 
2] android:layout width- "wrap content" 
28 android:layout toLeftOf- "@ id/canoel" 
29 android:layout alignTop= "8 id/cancel" 
30 android:text- "fifi iJ "> 

a3 < Button» 

32  «/Relativelayout^ 


在 上 面 的 代码 中 ,首先 在 第 3 CHER T — RelativeLayout > fg 4& j5 B] — AHX B J s 
* 15 行使 用 位 置 属性 android:layout below 确定 EditText 控件 在 ID 为 label 的 元 素 下 
方 ;第 20 行使 用 属性 android:layout_alignParentRight 声明 该 元 素 与 其 父 元 素 的 右边 边 
界 对 齐 ; 第 21 行使 用 属性 android:layout_marginLeft 将 该 元 素 相左 移动 10dip; 第 22 行 


声明 该 元 素 在 ID 为 entry 的 元 素 下 方 ;第 28 行 声明 
声明 该 元 素 在 ID 为 cancel 元 素 的 左边 ;第 29 行使 用 
该 元 素 与 ID 为 cancel 的 元 素 在 相同 的 水 平 位 置 。 


535 绝对 布局 


使 用 属性 android:layout_toLeftOf 
属性 android:layout_alignTop 声明 


绝对 布局 (AbsoluteLayout) 能 通过 指定 界面 元 素 的 坐标 位 置 ,来 确定 用 户 界面 的 整 
体 布局 。 绝 对 布局 是 一 种 不 推荐 使 用 的 界面 布局 ,因为 通过 绝对 位 置 确定 的 界面 元 素 ， 


Android 系统 不 能 够 根据 不 同 屏幕 对 界面 元 素 的 位 
置 进行 调整 ,降低 了 界面 布局 对 不 同类 型 和 尺寸 屏幕 
的 适应 能 力 。 使 用 绝对 布局 往往 在 目标 手机 上 非常 
完美 ,但 在 其 他 不 同类 型 的 手机 上 ,界面 布局 却 变 得 
混乱 不 堪 。 

图 5. 24 是 绝对 布局 的 一 个 示例 ,每 一 个 界面 控 
件 都 必须 指定 坐标 (X,Y) ,例如 “确认 ”按钮 的 坐标 是 
(40,120)，“ 取 消 ?按钮 的 坐标 是 (120,120)。 坐 标 原 
点 (0,0) 在 屏幕 的 左上 角 。 

下 面 给 出 main. xml 文件 的 完整 代码 。 


[a AbsoluteLayout 


5.24 绝对 布局 


<?xml version- "1.0" encoding- "utf- 8"?» 


android:layout width- "fill parent" 
android:layout height- "fill parent" 


ET 
3 < Bbsolutelayout. android:id- "8 + id/Absolutelayout0l" 
4 
5 
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6 xmüns:android- "http://schemas.android.coom/apk/res/android"> 
7 < TextView android:id- "@ + id/label" 
8 android:layout x= "40dip" 
9 android:layout y= "40dip" 
10 android:layout height= "wrap content" 
1 android:layout width- "wrap content" 
2 android:text- "H P 4 : "> 
过 < /TextView> 
14 <EditText android:id- "@ + id/entry" 
15 android:layout x- "40dip" 
16 android:layout y= "60dip" 
0 android:layout height- "wrap content" 
18 android:layout width= "150dip"> 
19 < /EditText> 
20 <Button android:id- "@ + id/ok" 
2 android:layout_width= "70dip" 
22 android:layout height- "wrap content" 
23 android:layout x- "A0dip" 
24 android:layout y= "120dip" 
25 android:text- "if jÀ "> 
26 < /Button> 
paj < Button android:id= "@ + id/canoel" 
28 android:layout_width= "70dip" 
29 android:layout height- "wrap content" 
30 android:layout x- "120dip" 
3 android:layout y= "120dip" 
了 2 android:text- "lj ili "> 
33 < /Button» 
34  «/Bbsolutelayout^ 
536 网 格 布局 


网 格 布局 (GridLayout) 是 Android SDK 4. 0CAPI Level 14) 新 支持 的 布局 方式 ,将 用 
户 界面 划分 为 网 格 ,界面 元 素 可 随意 摆 放 在 这 些 网 格 中 。 网 格 布局 比 表格 布局 
(CTableLayout) 在 界面 设计 上 更 加 灵活 ,在 网 格 布局 中 界面 元 素 可 以 占用 多 个 网 格 ,而 在 
表格 布局 却 无 法 实现 ,只 能 将 界面 元 素 指定 在 一 个 表格 行 (TableRow) 中 ,不 能 跨越 多 个 
表格 行 。 

下 面 用 GridLayoutDemo 示例 说 明 网 格 布局 的 使 用 方法 。 图 5. 25 Ca) 和 图 5. 25(b) 
分 别 是 在 Eclipse 界面 设计 器 中 的 界面 图 示 和 在 Android 模拟 器 运行 后 的 用 户 界 面 。 

在 界面 设计 器 中 可 以 看 到 虚线 网 格 .但 在 模拟 器 的 运行 结果 中 是 看 不 到 的 。 网 格 布局 
将 界面 划分 成 多 个 块 ,这 些 块 是 根据 界面 元 素 动态 划分 的 。 具 体 地 讲 ,GridLayoutDemo 示 
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(a) 界面 设计 器 图 示 (b) 模拟 器 运行 结果 


图 5.25 GroidLayoutDemo 示例 


例 的 左边 第 一 列 的 宽度 ,是 在 综合 分 析 第 一 列 中 的 两 个 界面 元 素 “ 用 户 名 ”TextView 和 
j"TextView 宽度 基础 上 设 定 的 , 即 选 择 两 个 元 素 中 最 宽 元 素 的 宽度 作为 第 一 列 的 
宽度 。 同 样 ,最 上 方 第 一 行 的 高 度 , 也 是 分 析 “ 这 是 关于 GridLayout 的 示例 ”这 个 
TextView 元 素 的 高 度 后 设 定 的 。 因 此 ,网 格 布局 中 行 的 高 度 和 列 的 宽度 ,完全 取决 于 本 
行 或 本 列 中 ,高 度 最 高 或 宽度 最 宽 的 界面 元 素 

但 在 网 格 布局 中 ,界面 元 素 是 可 以 跨越 多 个 块 的 ,例如 “这 是 关于 GridLayout 的 示 
例 ” 这 个 TextView 元 素 就 占据 纵向 4 个 块 ,“ 用 户 名 :“ 这 个 TextView 元 素 在 纵向 仅 占 
用 了 1 个 块 ,而 用 户 名 输入 框 控件 EditText 在 纵向 上 占用 了 2 个 块 。 这 个 示例 中 没有 横 
向 占用 多 个 块 的 界面 元 素 , 但 这 样 设计 在 网 格 布局 中 是 允许 的 。 

下 面 给 出 main. xml 文件 的 全 部 代码 。 


1 <?xml version- "1.0" encoding- "utf- 8"?> 

2  «Grdlayout 

3 xmins:android- "http: //schemas android. oa/apk/res/android" 
4 

5 android:layout width- "match parent" 

6 android:layout height- "match parent" 

7 android:useDefaultMargins- "true" 

8 android:columCount- "4" > 

9 

10 < TextView 

android:layout columnSpan- "4" 

12 android:layout gravity- "center horizontal" 
13 android:text- "这 是 关于 GridLayout 的 示例 " 


14 android:textSize- "20dip"/» 
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15 
16 < TextView 

17 android:text- "H P% : " 

18 android:layout gravity- "right"/» 

19 

20 «EditText 

21 android:ems- "8" 

22 android:layout columSpan- "2"/> 

23 

24 « TextView 

25 android:text- "if i): " 

26 android:layout colum- "0" 

21 android:layout gravity- "right"/» 

28 

29 «EditText 

30 android:ems- "8" 

a android:layout columnSpan- "2"/> 

2 

3 « Button 

3 android:text- "清空 输入 " 

35 android:layout colum- "1" 

36 android:layout gravity- "fill horizontal"/» 
3 

38 « Button 

39 android:text- "下 一 步 " 

40 android:layout colum- "2" 

a android:layout gravity- "fill horizontal"/> 
42 

43 </Gridrayout> 


代码 第 7 行 的 useDefaultMargins 表示 网 格 布局 中 的 所 有 元 素 都 遵循 默认 的 边缘 规 
则 ,就 是 说 所 有 元 素 之 间 都 会 留 有 一 定 的 边界 空间 。 代 码 第 8 行 的 columnCount 表示 纵 
向 分 为 4 列 , 从 第 0 列 到 第 3 列 ,程序 开发 人 员 也 可 以 在 这 里 定义 横向 的 行 数 ,使 用 
rowCount 属性 。 

代码 第 11 行 的 layout_columnSpan 属性 表示 TeixtView 控件 所 占据 的 列 的 数量 。 
代码 第 12 行 的 layout_gravity 王 "center_horizontal" 表 示 文 字 内 容 在 所 占据 的 块 中 居中 
显示 。 

代码 第 10 行 到 第 14 行 定义 了 第 一 个 界面 控件 ,虽然 定义 了 纵向 所 占据 的 块 的 数 
量 , 但 却 没有 定义 元 素 起 始 位 置 所 在 的 块 ,原因 是 网 格 布局 中 的 第 1 个 元 素 默 认 在 第 
0 行 第 0 列 。 

代码 第 16 行 到 第 18 行 定义 了 第 2 个 界面 控件 ,仍然 没有 定义 元 素 起 始 位 置 所 在 的 
块 。 根 据 网 格 布局 界面 元 素 的 排 布 规则 ,如 果 没 有 明确 说 明 元 素 所 在 的 块 ,那么 当前 元 
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素 会 放置 在 前 一 个 元 素 的 同一 行 右 侧 的 块 上 ;如 果 前 一 个 元 素 已 经 是 这 一 行 的 末尾 块 ， 
则 当前 元 素 放置 在 下 一 行 的 第 一 个 块 上 ;如 果 当 前 元 素 在 纵向 上 占据 多 个 块 ,而 前 一 个 
元 素 右 侧 没有 足够 数量 的 块 , 则 当前 元 素 的 起 始 位 置 也 会 放置 在 下 一 行 的 第 一 个 块 上 。 
代码 第 26 行 的 layout. column 属性 表示 当前 元 素 列 的 起 始 位置 。 如 果 layout _ 
column 所 指定 的 列 的 位 置 在 当前 行 已 经 被 占用 , 则 当前 元 素 也 会 放置 在 下 一 行 的 这 一 
A. 
在 网 格 布局 中 没有 定义 的 属性 是 具有 默认 值 的 ,具体 默认 值 可 以 参考 表 5. 3。 


表 5.3 网 格 布局 中 属性 的 默认 值 


属 性 R 认 值 备 注 
width WRAP_CONTENT 
height WRAP CONTENT 
topMargin 0 当 用 户 将 useDefaultMargins 设置 为 false 
leftMargin 0 当 用 户 将 useDefaultMargins 设置 为 false 
bottomMargin 0 当 用 户 将 useDefaultMargins 设置 为 false 
rightMargin 0 当 用 户 将 useDefaultMargins 设置 为 false 
rowSpec. row UNDEFINED 
rowSpec. rowSpan 1 
rowSpec. alignment BASELINE 
columnSpec. column UNDEFINED 
columnSpec. columnSpan 1 
columnSpec. alignment LEFT 
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菜单 是 应 用 程序 中 非常 重要 的 组 成 部 分 .能 够 在 不 占用 界面 空间 的 前 提 下 ,为 应 用 
程序 提供 统一 的 选择 功能 和 设置 界面 ,并 为 程序 开发 人 员 提 供 易 于 使 用 的 编程 接口 。 
Android 系统 支持 三 种 菜单 模式 ,分 别 是 选项 菜单 (option menu) 、 子 菜单 (submenu) 和 快 
捷 菜单 (context menu) 。 


541 菜单 资源 


Android 程序 的 菜单 可 以 在 代码 中 动态 生成 ,也 可 以 使 用 XML 文件 制作 菜单 资源 ， 
然后 通过 inflateO 函数 映射 到 程序 代码 中 。 使 用 XML 文件 描述 菜单 是 较 好 的 选择 ,可 
以 将 菜单 的 内 容 与 代码 分 离 , 且 有 利于 分 析 和 调整 莱 单 结构 。 

下 面 的 代码 是 MenuResource 示例 main menu. xml 文件 的 全 部 代码 。 


E <?xml version- "1.0" encoding- "utf- 8"?» 
2 «menu xmins:android- "http: //schemas .android.con/apk/res/android" 
3 < item android: id- "@ + id/main menu 0" 
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4 android:icon- "@ drawable/pic0" 
5 android:title- "jT E] "/> 

6 < item android:id- "Q + id/main menu 1" 
7 android: icon- "@ drawable/picl" 
8 android:title- "jr £t "/> 

9 < item android:id- "Q + id/main menu 2" 
10 android:icon- "@ drawable/pic?" 
nu android:title- "llf fF "/> 

12 < item android:id- "@ + id/main menu 3" 
3 android:icon- "@ drawable/pic3" 
14 android:title- "设置 "/> 

15 < item android:id- "@ + id/main menu 4" 
16 android:icon- "@ drawable/pic4" 
n android:title- "订阅 "/> 

18 </menu> 


上 面 的 代码 生成 的 菜单 如 图 5. 26 所 示 , 生 成 具有 5 个 子 项 的 菜单 。 代 码 第 2 行 的 


menu 是 菜单 的 容器 ,菜单 资源 必须 以 menu 作为 根 元 
素 。 代 码 第 3 fT item 是 菜单 项 ,其 属性 值 id icon 和 
title 分 别 是 菜单 项 的 ID 值 ` 图 标 和 标题 。 代 码 第 4 行 
以 及 后 续 的 代码 中 ,虽然 定义 了 菜单 项 的 图 标 , 但 菜单 
资源 选择 的 菜单 模式 不 同 ,菜单 项 图 标 可 能 会 不 显示 。 
MenuResource 示例 使 用 的 是 选项 菜单 .因此 菜单 项 的 
图 标 没有 显示 ,而 仅 显示 了 菜单 项 的 标题 。 


542 选项 菜单 


选项 菜单 是 一 种 经 常 使 用 的 Android 系统 菜单 ,用 
户 可 以 通过 “菜单 键 ”"(MENU key) 打 开 选 项 菜单 。 

在 Android 2. 3 之 前 的 系统 中 ,选项 菜单 分 为 图 标 
菜单 (icon menu) 和 浮动 菜单 (overflow menu) ,通过 “ 菜 
单 键 ”直接 打开 的 是 图 标 菜单 ,如 图 5. 27 所 示 。 顾 名 思 


图 5.26  MenuResource 示例 界面 


义 ,图 标 菜单 就 是 能 够 同时 显示 文字 和 图 标的 菜单 ,最 多 支持 6 个子 项 。 如 果子 项 多 于 


6 个 , 则 需要 扩展 菜单 显示 其 他 的 子 项 。 


浮动 菜单 是 垂直 的 列表 型 菜单 ,如 图 5. 28 所 示 , 仅 在 图 标 菜单 子 项 多 于 6 个 时 才 出 
现 ,通过 点 击 图 标 菜单 最 后 的 子 项 More 才能 打开 。 浮 动 菜 单 不 能 够 显示 图 标 ,但 支持 单 
选 框 和 复 选 框 ;相反 ,图 标 菜 单 支持 显示 图 标 ,但 不 支持 单 选 框 和 复 选 框 。 

在 Android 4. 0 系统 中 ,选项 菜单 只 出 现 浮动 菜单 ,而 不 再 出 现 如 图 5. 27 所 示 的 图 


标 菜单 ,图 标 菜 单 的 部 分 功能 由 操作 栏 代替 实现 。 
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菜单 子 项 5 
菜单 子 项 6 
如 单子 m7 
菜单 子 项 8 国 
© 菜单 子 项 9 w 
cox rouen More 菜单 子 项 10 ij 
图 5.27 图 标 菜单 图 5.28 浮动 菜单 


在 Android 4.0 系统 中 ,Activity 在 创建 时 会 调用 onCreateOptionsMenu O 函数 初始 
化 自身 的 菜单 系统 。 在 Activity 的 整个 生命 周期 中 ,选项 菜单 是 一 直 被 重复 利用 的 , 直 
到 Activity 被 销毁 。 在 Android 2. 3 之 前 的 系统 中 ,onCreateOptionsMenu() 函 数 只 有 在 
用 户 点 击 “ 菜 单 键 " 后 才 被 调用 ,就 是 说 选项 菜单 是 在 需要 的 时 候 才 被 创建 的 。 但 
Android 4. 0 系统 需要 在 程序 的 顶部 显示 操作 栏 ,操作 栏 的 初始 化 代码 也 在 
onCreateOptionsMenu() 函 数 中 ,因此 该 函数 在 Activity 创建 时 就 会 被 调用 。 

重 载 onCreateOptionsMenu() 函 数 的 主要 目的 是 初始 化 菜单 ,可 以 使 用 XML 文件 
的 菜单 资源 ,也 可 以 使 用 代码 动态 加 载 菜 单 。 下 面 的 代码 是 使 用 main_menu. xml 文件 
作为 菜单 资源 初始 化 Activity 的 菜单 。 


1 @ Override 

2  pblic boolean onCreateOptionsMenu (Menu menu) { 
3 MenuInflater inflater- getMenuInflater () ; 
4 inflater.inflate (R.menu.main menu, menu); 
5 retum true; 

6 ) 


在 用 户 选择 菜单 项 后 ,Android 系统 会 调用 onOptionsItemSelected O PR ,一 般 将 菜 
单 选择 事件 的 响应 代码 放置 在 onOptionsItemSelected() 函数 中 。onOptions- 
ItemSelected() 函数 会 返回 用 户 选择 的 Menultem, 可 以 通过 getItemId C) 函数 获取 
Menultem 的 ID ,这 个 ID 就 是 用 户 在 XML 文件 中 为 每 个 菜单 项 所 设 定 的 android:id Jii 
性 值 。 

onOptionsItemSelected O 函数 在 每 次 用 户 点 击 菜单 子 项 时 都 会 被 调用 。 下 面 的 代码 
说 明 如 何 通过 菜单 子 项 的 子 项 ID 执行 不 同 的 操作 。 


1 override 

2 public boolean anoptionsTtemSelected (MenuTtem item) { 

3 TextView label= (TextView) findViesById(R.id.label); 
4 

5 

6 


switch (item.getItemId()) ( 
case R.id.main menu 0: 
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7 label.setText ("jT EJ] ,菜单 TD: "+ item.getItemId()); 
8 retum true; 

9 case R.id.main menu 1: 

10 label.setText ("jj & ,3E Ó& ID: "+ item.getItemId()); 
nu retum true; 

12 case R.id.main menu 2: 

13 label.setText ("邮件 ,菜单 ID: "+ item.getItemId()); 
14 retum true; 

15 case R.id.main menu 3: 

16 label.setText ("设置 ,菜单 ID: "+ item.getItemId ()); 
17 retum true; 

18 case R.id.main menu 4: 

19 label.setText ("订阅 ,菜单 ID: "+ item.getItemId ()) ; 
20 retum true; 

p default: 

22 retum false; 

23 ) 

24 } 


函数 onOptionsItemSelected() 的 返回 值 表示 是 否 需要 其 他 事件 处 理 函 数 菜单 选择 
事件 进行 处 理 , 如 果 不 需 要 其 他 函数 处 理 该 事件 , 则 返回 true, 否 则 返回 false, 


代码 第 5 行 的 getItemId( ) 函数 获取 到 被 选择 菜单 子 项 的 ID。 代 码 第 7 行 通过 在 
XML 文件 中 定义 的 菜单 ID 与 getItemId() 函数 的 返回 值 进行 匹配 。 
选项 菜单 的 代码 可 参考 OptionsMenu 示例 ,程序 运行 后 通过 点 击 “ 菜 单 键 "可 以 调 出 


选项 菜单 ,如 图 5. 29(a) 所 示 。 


[ optionvenu 


Dr 131099649 


(a) OptionsMenu 示 例 (b) OptionsMenu2 示 例 


图 5.29 选项 菜单 示例 界面 
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开发 人 员 除 了 可 以 使 用 XML 文件 的 菜单 资源 以 外 ,还 可 以 在 代码 中 动态 生成 菜单 。 
OptionsMenu2 示例 说 明 如 何 使 用 代码 生成 的 菜单 ,所 生成 的 菜单 内 容 与 OptionsMenu 
示例 的 菜单 完全 一 样 ,如 图 5. 29(b) 所 示 。 

开发 人 员 首 先 要 在 代码 中 定义 菜单 ID ,然后 在 onCreateOptionsMenu O 函数 中 添加 
选项 菜单 ,并 设置 菜单 的 标题 和 图 标 等 信息 。 


1 final static int MENU 00-Menu.FIRST; 

2 final static int MNJ 0]-MEnu.FTRST+ 1; 
3 final static int MENU 02-MEnu.FTRST+ 2; 
4 fima static int MNU 03-MEnu.FTRST+ 3; 
5 final static int MENJ 04- Menu. FIFST* 4; 
6 

1 

8 

9 


G Override 
public boolean onCreateOptionsMenu (Menu menu) ( 
menu.add(0,MENU 00,0, "fT E} ") .setIcon (R.drawable.picO) ; 


10 menu.add (0, MENU. 01,1, "$i t ") set Icon (R.drawable.picl); 
nu menu.add (0, MENU 02,2, "Il; ^F ") .setIcon (R.drawable.pic?) ; 
12 menu.add (0, MENU. 03,3, "Ù 1t ") .setIcon (R.drawable.pic3) ; 
3 menu.add (0,MENU 04,4, "ÌT [R] ") .setIcon (R-drawable.pic4) ; 
14 retum true; 


15 ] 


一 般 将 菜单 项 的 ID 定义 成 静态 常量 (代码 第 1 行 至 第 5 行 ), 并 使 用 静态 常量 
Menu.FIRST( 整 数 类 型 , 值 为 1) 定义 第 一 个 菜单 子 项 ,以 后 的 菜单 项 仅 须 在 Menu 
.FIRST 增加 相应 的 数值 即 可 。 

在 onCreateOptionsMenuO 函数 中 ,函数 的 返回 类 型 为 布尔 值 (代码 第 14 行 ) ,返回 
true 则 可 显示 在 函数 中 设置 的 菜单 ,否则 将 不 能 够 显示 菜单 。 

Menu 对 象 作 为 一 个 参数 被 传递 到 函数 内 部 ,因此 在 onCreateOptionsMenu O ) 函数 
中 ,用 户 可 以 使 用 Menu 对 象 的 add O 函数 添加 菜单 项 。 

add O 函数 的 语法 : 


MEnuTtem android.view.Meru.add (int groupId, int itemld, int order, CharSeguence title) 


add O 函数 的 第 1 个 参数 groupId 是 组 ID ,用 以 批量 地 对 菜单 子 项 进行 处 理 和 排序 ; 
第 2 个 参数 itemId 是 子 项 ID, 是 每 一 个 菜单 子 项 的 唯一 标识 ,通过 子 项 ID 使 应 用 程序 
能 够 定位 到 用 户 所 选择 的 菜单 子 项 ;第 3 个 参数 order 是 定义 菜单 子 项 在 选项 菜单 中 的 
排列 顺序 ;第 4 个 参数 title 是 菜单 子 项 所 显示 的 标题 。 

另外 ,通过 setIcon O 函数 可 以 为 菜单 子 项 添加 图 标 ,需要 将 图 像 资源 文件 复制 到 
/res/drawable 目录 下 。 
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543 子 菜单 


了 菜单 就 是 二 级 菜单 ,用 户 点 击 选项 菜单 或 快捷 菜单 中 的 菜单 项 就 可 以 打开 子 菜 
单 。 当 程序 具有 大 量 的 功能 时 ,可 以 将 相似 的 功能 划分 成 组 ,选项 菜单 可 用 来 表示 功能 
组 ,而 具体 功能 则 可 由 子 菜单 进行 选择 。 

传统 的 子 菜单 一 般 采 用 树 型 的 层次 化 结构 ,但 Android 系统 却 使 用 浮动 窗 体 的 形式 
显示 菜单 子 项 。 采 用 与 众 不 同 的 显示 方式 ,主要 是 为 了 更 好 适应 小 屏幕 的 显示 方式 。 子 
菜单 不 支持 和 能 套 , 也 就 是 说 不 能 够 在 子 菜单 中 使 用 子 菜单 。 

下 面 以 SubMenu 示例 说 明 如 何 使 用 XML 文件 设计 子 菜单 。SubMenu 示例 的 用 户 
界面 如 图 5. 30 所 示 。 

SubMenu 示例 选项 菜单 包含 两 个 菜单 项 :“ 设 置 " 和 “新 建 *"。 菜 单项 “设置 "包含 子 
菜单 , 子 菜单 中 只 有 1 个 菜单 项 “打印 ”。 菜 单项 “新 建 ”" 包 含 子 菜单 , 子 菜单 中 有 2 NK 
单项 ,分 别 是 “邮件 "和 “订阅 ”。SubMenu 示例 的 菜单 结构 如 图 5. 31 所 示 。 


SubMenu 


(十 ) 设 置 
(一 ) 打 印 
(十 ) 新 建 
(一 ) 邮 件 
(一 ) 订 阅 


5.30 SubMenu 示例 界面 5.31 SubMenu 示例 的 菜单 结构 


SubMenu 示例 使 用 XML 文件 描述 菜单 结构 ,sub_menu. xml 文件 代码 如 下 。 


1 <?xml version "1.0" encoding- "utf- 8"?> 

2 «menu xmins:android- "http: //schemas android. oawapk/res/android' 
3 < item android:id- "@+ id/main menu 0" 

4 android: icon- "@ drawable/picO" 

5 android:title- "iit "> 

6 «menu» 

7 < item android:id- "@ + id/sub menu 0 0" 

8 android:icon- "@ drawable/pic4" 

9 android:title- "fT Ef "/> 

10 < fen 


nu < /itm> 

2 < item android:id- "@ + id/main menu 1" 

13 android:icon- "@ drawable/picl" 

14 android:title- "jp Æ "> 

15 «meni 

16 < item android:id- "@ id/sub menu 1 0" 
17 android: icon= "@ drawable/pic?" 

18 android:title= " 哪 件 "/> 

19 < item android:id- "e+ id/sub menu 1 1" 
20 android:icon- "@ drawable/pic3" 

2 android:title- "订阅 "/> 

22 < fmen 

23 < fiten» 

24  « men 


代码 第 6 行 至 第 10 行 是 一 个 子 菜单 的 描述 。 子 菜单 也 使 用 二 menu 二 标签 进行 声 
明 ,内 部 使 用 一 item 过 标签 描述 菜单 项 

Android 系统 的 子 菜单 使 用 起 来 非常 灵活 ,除了 可 以 用 XML 文件 描述 菜单 结构 ,还 
可 以 通过 代码 在 选项 菜单 或 快捷 菜单 中 使 用 子 菜单 。SubMenu2 是 使 用 代码 实现 子 菜单 
的 示例 ,界面 如 图 5. 32 所 示 。 


5.32 SubMenu2 示例 界面 


SubMenu2 子 菜单 结构 与 SubMenu 示例 是 完全 相同 的 ,不 同 之 处 在 于 子 菜单 上 多 了 
标题 图 标 。 下 面 首先 给 出 SubMenu? 示例 的 核心 代码 。 


1 final static int MENU. 00=Menu.FIRST; 
2 final static int MENU 0l- Menu.FTRST* 1; 
3 fina static int SUB MENU 00 Ol-Menu.FTRST* 2; 
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4 fina static int SUB MENU 01 00=Menu.FIRST+ 3; 

5 final static int SUB MENJ 0l 0]=Menu.FIRST+ 4; 

6 

7 SubMenu subl- (SubMenu) menu.addSubMenu (0,MENU 00,0, "设置 ") 

8 -SetHeaderIcon (R.drawable.pic3) ; 

9 subl.adi(0,SUB MENU 00 01 ,0,"jT E} ") .setIcon (R.drawable.picO) ; 
10 


1l Sienu sb (SukMenu) menu.addSubMenu (0, MENU. 01,1, "ii E ") 

12 -SetHeaderIcon (R.drawable.picl) ; 

13  subP.add(0,SUB MENU Ol 00 ,0, "H fF ") .setIcon (R.drawable.pic?) ; 
14  sub?.add(0,SUB MENU Ol 01 ,0," 订 阅 ") .setIcon (R.drawable.pic4); 


代码 第 1 行 至 第 5 行 是 定义 选项 菜单 和 子 菜单 所 有 菜单 项 的 ID。 代 码 第 7 行使 用 
addSubMenu() 函数 在 选项 菜单 中 增加 了 1 个 菜单 项 MENU_00, 当 用 户 点 击 这 个 菜单 项 后 
会 打开 子 菜单 。addSubMenu() 函数 共有 4 个 参数 ,参数 1 是 组 ID, 如 果 不 分 组 , 则 可 以 使 用 
0; 参 数 2 是 菜单 项 的 ID; 参 数 3 是 显示 排序 ,数字 越 小 越 靠 近 列 表 上 方 ; 参 数 4 是 菜单 项 显 
示 的 标题 。 代 码 第 8 行 设置 了 子 菜单 的 图 标 。 代 码 第 9 行 在 子 菜单 中 添加 了 菜单 项 。 


544 快捷 菜单 


快捷 菜单 类 似 于 计算 机 程序 中 的 “右键 菜单 ”, 当 用 户 点 击 界面 上 某 个 元 素 超过 2 Tb 
后 ,将 启动 注册 到 该 界面 元 素 的 快捷 菜单 。 快 捷 菜 单 
同样 采用 浮动 的 显示 方式 ,虽然 快捷 菜单 的 现实 方式 
与 子 菜单 相同 ,但 两 种 菜单 的 启动 方式 却 截然 不 同 。 

后 面 内 容 将 用 ContextMenu 示例 说 明 如 何 使 用 
快捷 菜单 ,以 及 如 何 将 快捷 菜单 注册 到 某 个 界面 元 素 o 
上 。ContextMenu 示例 的 用 户 界面 如 图 5.33 所 示 。 E 

快捷 菜单 的 使 用 方法 与 选项 菜单 极为 相似 ,只 lasm | 
重 载 的 函数 不 同 而 已 。 快捷 菜单 需要 重 载 
onCreateContextMenu O 函数 初始 化 菜单 项 ,包括 添 DEAE, 
加 快捷 菜单 所 显示 的 标题 ,图 标 和 菜单 子 项 等 内 容 。 菜单 子 项 3 

下 面 的 代码 说 明 如 何 使 用 onCreateContextMenu() 


| | ontextMenu 


菜单 子 项 1 


函数 初始 化 菜单 项 。 5.33 ContextMenu 用 户 界面 
1 final static int OONTEXT MENU 1- Menu.FIRST; 
2 final static int OONTEXT MENU 2=Menu.FIRST+ 1; 
3 final static int OONIEXT MENU 3-Menu.FIRST* 2; 
4 @ Override 
5 public void onCreateContextMenu (ContextMenu menu, View v, 
ContextMenuInfo menuInfo) ( 
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vo 0 - o 


menu.setHeaderTitle ("De 5E 3E pr Bi n) ; 

menu.adi(0, CONTEXT MENU 1，0," 唆 单子 项 1"); 
menu.adi(0, CONTEXT MENU 2, 1," AFH 2"); 
menu.adi(0, CONTEXT MENU 3，2," 唆 单子 项 3"); 


上 面 的 代码 实现 了 一 个 具有 3 个 菜单 项 的 子 菜单 , 子 菜单 的 标题 是 “快捷 菜单 标 
题 "?。ContextMenu 类 支持 add() 函 数 ( 代 码 第 7 行 ) 和 addSubMenu() 函 数 ,可 以 在 快捷 
菜单 中 添加 菜单 子 项 和 子 菜单 。onCreateContextMenu() 函数 (代码 第 5 行 ) 的 第 1 个 参 
数 menu 是 需要 显示 的 快捷 菜单 ;第 2 个 参数 v 是 用 户 点 击 的 界面 元 素 ;第 3 个 参数 


menulnfo 是 所 选择 界面 元 素 的 额外 信息 。 


重 载 onContextItemSelected() 函 数 响 应 菜单 选择 事件 。 该 函数 在 用 户 选 择 快捷 菜 


单 中 的 菜单 项 后 被 调用 ,与 onOptionsItemSelected() 函数 的 使 用 方法 基本 相同 。 
下 面 代码 将 说 明 如 何 重 载 onContextItemSelected() 函 数 响 应 子 菜单 事件 。 


1 
2 
3 
4 
5 
6 
z 
8 
9 


@ Override 
public boolean onContextItemSelected (MenuTtem item) { 
Switch(item.getItemId()) ( 
case CONTEXT MENU 1: 
IabelView.setText (" 菜 单子 项 1"); 
return true; 
case CONTEXT MENU 2: 
IabelView.setText (" 菜 单子 项 2"); 
retum true; 
case OONTEXT MENU 3: 
IabelView.setText (" 菜 单子 项 3"); 
return true; 
) 
retum false; 
} 


最 后 ,还 需要 使 用 registerForContextMenu() 函 数 将 快捷 菜单 注册 到 界面 中 的 某 个 
控件 上 (下 面 代 码 第 7 行 )。 在 用 户 长 时 间 点 击 该 界面 控件 时 , 便 会 启动 快捷 菜单 。 同 
时 ,为 了 能 够 在 界面 上 直接 显示 用 户 所 选择 快捷 菜单 的 菜单 项 ,在 代码 中 引用 了 界面 元 
素 TextView( 下 面 代码 第 6 行 ), 通 过 更 改 TextView 的 显示 内 容 ( 上 面 代码 第 5、 第 8 和 


第 11 行 ), 显 示 用 户 所 选择 的 菜单 子 项 。 


1 
2 
3 
4 


TextView LabelView- null; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 


Super.onCreate (savedInstanceState) ; 
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setContentView (R. layout .main) ; 
LabelView- (TextView)findViewById(R.id.label); 
registerForContextMenu (LabelView) ; 

) 


c - oO u 


下 面 代码 是 /src/layout/main. xml 文件 的 部 分 内 容 , 第 1 行 声 明了 TextView 的 ID 
为 label, 在 上 面 代 码 的 第 6 行 中 ,通过 R. id. label 将 ID 传递 给 findViewById() 函 数 ,这 
样 用 户 便 能 够 引用 该 界面 元 素 , 并 能 够 修改 该 界面 元 素 的 显示 内 容 。 


1 —«TexView — android:id- "@ + id/label" 

2 ardroid:layout width- "fill parent" 
3 android:layout height- "fill parent" 
4 android:text- "@ string/hello" 

5 /> 


还 有 一 点 需要 注意 ,上 面 代码 的 第 2 行 ,将 android:layout_width 设置 为 fill_parent， 
这 样 TextView 将 填充 满 父 节点 所 有 剩余 的 屏幕 空间 ,用 户 点 击 屏幕 TextView 下 方 的 
任何 位 置 都 可 以 启动 快捷 菜单 。 如 果 将 android:layout_width 设置 为 wrap_content, 则 
用 户 必 须 准确 点 击 TextView 才能 启动 快捷 菜单 。 


55 操作 栏 与 Fayet 


操作 栏 和 Fragment 是 Android 3.0 新 引入 的 界面 控件 ,这 两 个 控件 一 定 程度 上 是 
为 了 适应 Android 平板 电脑 等 大 屏幕 设备 界面 设计 需要 而 产生 的 ,在 Android 4.0 系统 
中 得 到 了 进一步 的 发 展 , 可 以 良好 地 支持 不 同 屏幕 尺寸 的 设备 ,并 可 以 根据 屏幕 大 小 的 
不 同 改变 显示 内 容 。 


551 操作 栏 


操作 栏 (Action Bar) 代 替 传 统 的 标题 栏 功 能 ,图 5. 34 所 示 是 电子 邮件 程序 的 操作 
栏 。 操 作 栏 左 侧 的 图 标 是 应 用 程序 的 图 标 (logo) ,图 标 旁 边 是 应 用 程序 当前 Activity 的 
标题 , 右 侧 的 多 个 图 标 则 是 “选项 菜单 ”中 的 菜单 项 。 


Email a". 2 8 
图 5.34 电子 邮件 程序 的 操作 栏 


操作 栏 可 以 提供 多 个 实用 的 功能 ,包括 : 

CD 将 “选项 菜单 ”的 菜单 项 显示 在 操作 栏 的 右 侧 ; 

(2) 基于 Fragment 实现 类 似 于 Tab 页 的 导航 切换 功能 ; 
Go 为 导航 提供 可 “ 拖 忠 一 放 息 "的 下 拉 列 表 ; 

(4) 可 在 操作 栏 上 实现 类 似 于 “搜索 框 ?的 功能 。 
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默认 情况 下 ,所 有 高 于 Android 3. 0 的 系统 中 ,基于 holographic 主题 的 Activity 上 
方 都 存在 操作 栏 。 如 果 程 序 开 发 人 员 需 要 隐藏 Activity 的 操作 栏 , 则 可 以 在 
AndroidManifest. xml 文件 中 添加 如 下 代码 。 


< activity android:theme- "8 android:style/Theme.Holo.NoActionBar' 


或 者 在 代码 中 加 入 : 


ActionBar actionBar- getActionBar(); 
actionBar.hide() ; 


在 操作 栏 被 隐藏 后 ,Android 系统 会 自动 调整 界面 元 素 , 填 充 隐藏 操作 栏 所 腾 出 的 
空间 。 

操作 栏 右 侧 用 来 显示 “选项 菜单 "的 菜单 项 ,但 所 显示 的 内 容 会 根据 操作 栏 所 具有 的 
空间 不 同 而 具有 不 同 的 实现 方式 。 在 屏幕 尺寸 较 小 的 设备 上 ,操作 栏 会 自动 隐藏 菜单 项 
的 文字 ,而 仅 显 示 菜 单项 的 图 标 ; 而 在 屏幕 尺寸 较 大 的 设备 上 ,操作 栏 会 同时 显示 菜单 项 
的 文字 和 图 标 。 

将 “选项 菜单 ”的 菜单 项 标识 为 可 在 操作 栏 中 显示 的 代码 非常 简单 ,只 需要 在 XML 
菜单 资源 文件 的 item 标签 中 添加 下 面 第 6 行 代码 即 可 。 


1 <?xml version- "1.0" encoding- "utf- 8"?> 
2 «menu xmins:android- "http: //schemas.android. con/apk/res/android"» 
3 < item android:id- "@ + id/main menu 0" 

4 android:icon- "@ drawable/picO" 

5 android:title- "JT Ép" 

6 android:showAshction- "ifRocm| withiText"/» 

7 < henu> 


第 6 行 代码 中 的 ifRoom 表示 如 果 操 作 栏 有 剩余 空间 , 则 显示 该 菜单 项 的 图 标 ; 
withText 表示 显示 图 标的 同时 显示 文字 标题 。 

下 面 首先 以 ActionBar 示例 说 明 如 何在 操作 栏 上 显示 选项 菜单 。ActionBar 示例 的 
运行 界面 如 图 5. 35 所 示 ,其 中 图 5. 35(a) 是 WXGA720 (1280X720) 分 辩 率 下 的 显示 效 
果 , 其 中 图 5. 35(b) 是 WVGA800(480X800) 分 辨 率 下 的 显示 效果 。 由 此 可 见 ,分辩 率 的 
大 小 和 屏幕 的 方向 ,一 定 程度 上 决定 了 操作 栏 的 实现 内 容 和 实现 方式 。 

ActionBar 示例 与 OpionMenu 示例 的 代码 基本 相同 ,基本 思想 都 是 使 用 XML 文件 
的 菜单 资源 ,然后 在 Activity 中 通过 onCreateOptionsMenu O 函数 加 载 选项 菜单 ,并 调用 
onOptionsItemSelected O 函数 处 理 菜 单 选择 事件 。 

不 同 之 处 在 于 , ActionBar 示例 main. menu. xml 文件 中 的 所 有 菜单 项 都 添加 了 
ifRoom 和 withText 标志 位 ,可 以 在 操作 栏 中 显示 图 标 和 文字 标题 。 

main_menu. xml 文件 的 完整 代码 如 下 。 
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[a ActionBar 


Hello World, ActionBarActivity! 


(a) WXGA720(1280x 720) 


ET 
| Actionaar $e 


TEHE 


(b) WVGA8O0(480x 800) 


图 5.35 ActionBar 示例 用 户 界面 


1 <?xml version- "1.0" encoding- "utf- 8"?» 

2 «men xmins:android- "http://schemas.android.con/apk/res/android" 
3 < item android:id- "@ + id/main menu 0" 

4 android:icon- "8 drawable/picO" 

5 android:title- "JT E] " 

6 android:showAsAction- "ifRooam| withText"/» 

7 < item android:id- "@ + id/main menu 1" 

8 android:icon- "8 drawable/picl" 

9 android:title- "新 建 " 

10 android:showAsAction- "ifRoom| withText"/> 


n < item android:id- "8 + id/main menu 2" 

12 android:icon- "@ drawable/pic2" 

13 android:title- "flf fF" 

14 android:showAsAction- "ifRoom| withText"/> 
15 < item android:id- "à + id/main menu 3" 

16 android:icon- "8 drawable/pic3" 

17 android:title= "设置 " 

18 android:showAsAction- "ifRoom| withText"/> 
19 < item android:id- "8 + id/main menu 4" 

20 android:icon- "8 drawable/pic4" 

2 android:title- "订阅 " 

22 android:showAsAction- "ifRoom| withText"/> 
23  «/men» 


ActionView 示例 是 在 ActionBar 示例 基础 上 做 的 修改 ,在 操作 栏 上 增加 了 文字 输入 


功能 。ActionView 示例 的 运行 界面 如 图 5. 36 所 示 ,这 是 在 WXGAT20(1280 x 7200 4: BE 
率 下 的 显示 效果 。 


| EXT 


图 5.36  ActionView 示例 用 户 界面 
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在 菜单 项 中 添加 自 定义 显示 内 容 . 实 现 的 方法 是 在 item 标签 中 添加 android: 
actionLayout 属性 ,并 将 属性 值 定义 为 需要 显示 的 布局 文件 。ActionView 示例 在 main_ 
menu. xml 文件 中 添加 了 下 面 的 第 5 行 代码 。 


1 <itemandroid:id-"@ +id/main menu 0" 

2 android:icon- "@ drawable/pic0" 

3 android:title- "jT E] " 

4 android:showAshction- "ifRoom| withText" 

5 android:actionLayout- "@ layout/printview"/> 


代码 第 5 行 表示 显示 该 菜单 项 时 ,采用 /layout/printview. xml. 文件 作为 自 定 义 
布局 。 
printview. xml 文件 的 完整 代码 如 下 。 


<?xml version- "1.0" encoding- "utf- 8"?> 

2 < LinearTayout xmlns:android- "http://sdhemas.android.oa/ark/ res/android" 
3 android:layout width- "wrap content" 

4 android:layout height- "wrap content" 

5 android:orientation- "horizontal" 

6 

7 « ImageView 

8 android:layout width- "wrap content" 

9 android:layout height- "wrap content" 

10 android:src- "8 drawable/pic0"/» 

1l 

12 «EditText 

13 android:layout width- "wrap content" 

14 android:layout height- "wrap content" 

15 android:hint- "输入 需要 打印 的 文件 名 称 " 
16 android:ems- "12"/> 


18  «/Linearlayout^ 
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Fragment 的 主要 目的 在 大 屏幕 设备 上 实现 灵活 、 动 态 的 界面 设计 。 例 如 ,在 
Android 的 平板 电脑 上 ,因为 屏幕 有 更 多 的 空间 来 放置 更 多 的 界面 组 件 ,并且 这 些 组 件 之 
间 还 会 产生 一 定 的 数据 交互 。 

Fragment 支持 这 种 设计 理念 ,开发 人 员 不 需要 管理 复杂 的 视图 结构 变化 ,而 把 这 些 
动态 的 管理 工作 交 给 Fragment 和 回 退 堆栈 (back stack) 完 成 。 在 进行 界面 设计 时 ,只 需 
要 将 界面 布局 按照 功能 和 区 域 划分 为 不 同 的 模块 ,每 个 模块 设计 成 一 个 Fragment 即 可 。 

例如 ,在 图 5. 37 所 示 的 新 闻 阅 读 程序 中 ,将 界面 划分 为 左右 两 部 分 ,并 使 用 两 个 
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Fragment 实现 。 左 侧 用 来 展示 新 闻 列 表 , 右 侧 用 来 阅读 新 闻 的 具体 内 容 。 两 个 
Fragment 可 以 并 排 地 放置 在 同一 个 Activity 中 , 且 这 两 个 Fragment 都 具有 自己 的 生命 
周期 函数 和 界面 输入 事件 。 如 果 不 使 用 Fragment, 开 发 人 员 就 需要 在 一 个 Activtiy 中 实 
现 展示 新 闻 列 表 ,而 在 另 一 个 Activtiy 中 显示 新 闻 的 具体 内 容 。 使 用 Fragment 就 可 以 
将 两 部 分 功能 合并 到 同一 个 Activity 中 实现 。 


PR 智能 手机 1 
| 在 同一 个 Activity 中 的 两 个 Activity 中 的 | 
| 两 个 不 同 的 Fragment 两 个 Fragment ! 
1 

| (M | 
| 1 
i 1 
| 1 
1 1 
| 1 
i 1 
| 
| 

| 要 0-7! 
1 1 
l I 


Fragment 被 设计 成 为 可 重用 的 模块 ,每 个 Fragment 都 有 自己 的 布局 和 生命 周期 回 
调 函 数 ,可 以 将 同一 个 Fragment 放置 到 多 个 不 同 的 Activity 中 。 为 了 重复 使 用 
Fragment, 开 发 人 员 应 该 避免 直接 从 一 个 Fragment 去 操纵 另 一 个 Fragment. 这 样 会 增 
加 两 个 Fragment 之 间 的 耦合 度 ,不 利于 模块 的 重用 。 

Fragment 的 另 一 个 重要 特性 就 是 通过 不 同 的 Fragment 组 合 , 可 以 适应 不 同 尺 寸 的 
屏幕 。 以 前 面 介绍 的 新 闻 阅 读 程序 为 例 来 说 ,如 果 需 要 程序 同时 支持 平板 电脑 和 智能 手 
机 , 则 可 以 重用 为 平板 电脑 设计 的 两 个 Fragment, 在 智能 手机 端 将 两 个 Fragment 加 载 
到 两 个 Activity 中 。 

Fragment 具有 与 Activity 类 似 的 生命 周期 ,但 比 Activity 支持 更 多 的 事件 回调 函 
数 。Fragment 生命 周期 中 的 事件 回调 函数 ,以 及 之 间 的 调用 顺序 可 参考 图 5. 38. 


创建 onAttach() - onCreate() - onCreateView() | onActivityCreated( DH onStart() - onResume() | 一 | 


Fragment |^ | h 
: s. 
BEd id 
jas 
a> RE 


E E Um 一 |onDetachf H onDistroy View() - onDestroy View() - ws onPause() | 一 | 


图 5.38 Fragment 生命 周期 中 的 事件 回调 函数 


通常 情况 下 ,创建 Fragment 需要 继承 Fragment 的 基 类 ,并 至 少 应 实现 onCreate()、 
onCreateView() 和 onPause() 三 个 生命 周期 的 回调 函数 。 当 然 , 如 果 仅 通过 Fragment © 
示 元 素 ,而 不 进行 任何 的 数据 保存 和 界面 事件 处 理 , 则 仅 实现 onCreateView() 函 数 也 可 
创建 Fragment。 
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onCreate() 函 数 是 在 Fragment 创建 时 被 调用 的 ,用 来 初始 化 Fragment 中 的 必要 组 
件 。onCreateView() 函数 是 Fragment 在 用 户 界 面 上 第 一 次 绘制 时 被 调用 的 ,并 返回 
Fragment 的 根 布局 视图 。onPause() 函 数 是 在 用 户 离开 Fragment 时 被 调用 的 ,用 来 保 
存 Fragment 中 用 户 输 入 或 修改 的 内 容 。 

下 面 用 FragmentDemo 示例 说 明 如 何在 一 个 Activity 中 同时 加 载 两 个 Fragment， 
FragmentDemo 示例 的 用 户 界面 如 图 5. 39 所 示 。FragmentDemo 示例 以 屏幕 的 中 心 线 
为 界 , 在 一 个 Activity 中 并 列 加 载 了 两 个 Fragment, 左 侧 是 AFragment, 布 侧 是 
BFragment 。 

图 5. 40 是 FragmentDemo 示例 的 文件 结构 。 在 这 个 示例 中 ,每 个 Fragment 使 用 
个 Java 文件 实现 , 并 加 载 各 自 的 布局 文件 ,例如 在 AFragment. java 文件 中 实现 
AFragment, 并 加 载 布局 文件 frag. a. xml。 


El 


4 [i$ FragmentDemo! 
4 (8 src 
4 i edu.hrbeu.FragmentDemo 
[D AFragmentjava 
> [P BFragmentjava 
» [J) FragmentDemoActivityjava 
99 gen [Generated Java Files] 
> BÀ Android 4.0 
s assets 
» BB bin 
85 res 
» Q& drawable-hdpi 
，》 drawable-Idpi 
mentDemo b BE drawable-mdpi 
一 一 一 4 (& layout 
国 frag axml 
R) frag. bxml 
R main.xml 


v^ AF 选 项 è APA ? © values 
E) AndroidManifestxml 


no BF 按钮 [8] proguard.cfg 
国 projectproperties 


图 5.39  FragmentDemo 示例 的 用 户 界面 5.40 FragmentDemo 示例 的 文件 结构 


main. xml 文件 是 FragmentDemo 示例 中 唯一 的 Activity 的 布局 文件 , 两 个 
Fragment 在 界面 上 的 位 置 关 系 就 在 这 个 文件 中 进行 定义 。 下 面 给 出 main. xml 文件 的 
完整 代码 。 


1 «Lineriayout xmins:android- "http: //schems.android.oawark/res/android" 
2 android:orientation- "horizontal" 

3 android:layout width- "match parent" 

4 android:layout height- "match parent" 
5 
6 
7 


< fragment android:name- "edu.hrbeu.FragmentDermo.AFragment" 
android:id- "@+ id/fragment a" 
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8 android:layout weight- "1" 

9 android:layout width- "0px" 

10 android:layout height- "match parent"/» 
u 

12 < fragment android:name- "edu.hrbeu.FragmentDem.BFragnent" 
13 android:id- "@ + id/fragwent b" 

14 android:layout weight- "1" 

15 android:layout width- "Op" 

16 android:layout height- "match parent"/» 
17 

18  «/Linearlayout^ 


代码 第 6 行使 用 标签 fragment 声明 了 一 个 Fragment. Æ name 属性 中 用 “ 包 十 类 ”的 
方式 定义 了 AFragment 所 在 的 类 。 代 码 第 12 行 定义 了 BFragment。 代 码 第 8 行 和 第 
14 行 表明 两 个 Fragment 在 界面 上 的 布局 权重 是 一 样 的 ,因此 应 在 界面 上 各 占 50% 的 界 
面 空间 。 

FragmentDemoActivity 是 该 示例 主 界面 的 Activity, 加载 7 main. xml 文件 声明 的 
界面 布局 。FragmentDemoActivity. java 文件 的 完整 代码 如 下 。 


1 public class FragmentDemoActivity extends Activity { 
2 @ Override 

3 public void onCreate (Bundle savedInstanceState) { 
4 Super.onCreate (savedInstanceState) ; 

5 setContentView (R. layout .main) ; 

6 ) 

7 ) 


Android 系统 会 根据 代码 第 5 行 的 内 容 加 载 界面 布局 文件 main. xml. 然后 通过 
main. xml 文件 中 对 Fragment 所 在 的 “ 包 十 类 ”的 描述 ,找到 Fragment 的 实现 类 ,并 调用 
类 中 的 onCreateView O 函数 绘制 界面 元 素 。 

AFragment. java 文件 的 核心 代码 如 下 。 


1 public class AFragment extends Fragment( 
2 @ Override 

Bundle savedInstanceState) { 
return inflater.inflate(R.layout.frag a, container, false); 


oo con 


的 视 
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AFragment 中 只 实现 了 onCreateView O 函数 (代码 第 3 行 ) ,返回 值 是 AFragment 
图 。 代 码 第 4 行使 用 inflate() 函 数 ,通过 指定 资源 文件 R. layout. frag. a. 获取 到 


AFragment 的 视图 。 


最 后 给 出 frag. a. xml 文件 的 全 部 代码 : 


1 <?xml version- "1.0" encoding- "utf- 8"2» 

2 — «Linearlayout smins:androide- "http: //schemas.android.omm/apk/res/android" 

3 android:layout width- "wrap content" 

4 android:layout height- "wrap content" 

5 android:orientation- "vertical" 

6 

7 < TextView 

8 android: layout. width= "wrap content" 

9 android:layout height- "wrap content" 

10 android:text- "AFragrent"/» 

n 

12 < TextView 

13 android:layout width- "wrap content" 

14 amdroid:layout height- "wrap content" 

15 android:text- "这 是 AFragment 的 显示 区 域 ,通过 这 行文 字 可 以 看 到 与 
BFragment 的 边界 "/> 

16 

17 < CheckBox 

18 android:layout_width= "wrap content" 

19 android:layout height- "wrap content" 

20 android:text- "RE 选项 "/> 

p 

22 «Button 

23 android:layout width- "wrap content" 

24 android:layout height- "wrap content" 

25 android:text- "RE 按钮 "/> 


27 < Aünearlayout^ 
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Tab 


在 界面 控件 的 章节 中 介绍 过 使 用 TabHost 和 TabActivity 实现 Tab 导航 栏 的 功能 ， 
但 因为 TabActivity 已 经 过 期 ,所 以 这 里 介绍 一 种 新 方法 ,使 用 操作 栏 和 Fragment 实现 


导航 栏 。 


FHH FragmentTab 示例 说 明 如 何 使 用 操作 栏 和 Fragment 实现 Tab 导航 栏 ， 


FragmentTab 示例 的 用 户 界面 如 图 5. 41 所 示 。 
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FRAGMENT A FRAGMENT B 


v^ AF 选 项 


AF 按 钮 


FRAGMENT A FRAGMENT B 


图 5.41  FragmentTab 示例 的 用 户 界面 


第 一 个 Tab 页 的 标题 为 “FRAGMENT A”, 第 
两 个 Tab 页 分 别 加 载 了 不 同 的 Fragment, 两 个 
Fragment 所 显示 的 界面 元 素 略 有 不 同 。 从 
图 5.42 所 示 的 文件 结构 可 以 看 出 ,FragmentTab 
示例 和 FragmentDemo 示例 中 的 一 部 分 文件 的 文 
件 名 称 是 完全 相同 的 ,这 些 文件 中 的 代码 也 是 完 
全 相同 的 。 这些 文件 包括 AFragment. java, 
BFragment. java \frag_a. xml 和 frag b. xml。 这 里 
就 不 再 给 出 上 述 文件 的 源 代码 ,读者 可 以 参考 
FragmentDemo 示例 。 

建立 Tab 导航 栏 代 码 , 以 及 将 导航 栏 和 
Fragment 关联 起 来 的 代码 都 在 
FragmentTabActivity. java 文件 中 。 下 面 分 别 介 
绍 FragmentTabActivity. java 文件 中 的 核心 

先 给 出 onCreate() 函 数 的 代码 : 


-个 Tab 页 的 标题 为 “FRAGMENT B". 


I3. Package Explorer 23 
E FragmentTab. 
Ø src 
E edu.hrbeu.FragmentTab 
D) AFragmentjava 
国 BFragmentjava 
国 FragmentTabActivityjava 
B gen [Generated Java Files] 
mà Android 4.0 
D assets 
& bin 
D res 
© drawable-hdpi 
© drawable-ldpi 
© drawable-mdpi 
& layout 
国 frag_axml 
国 frag_bxml 
© values 
AndroidManifestxml 
[8) proguard.cfg 


D 


project properties 


图 5.42  FragmentTab 示例 的 文件 结构 


@ Override 
Super.onCreate (savedInstanceState) ; 


1 
3 
4 
5 final ActiorBar bar- getActionBar() ; 
6 
1 
8 
9 


bar.addTab (bar.newTab () 
10 -setText ("Fragment A") 


12 bar.addTab (bar .newTab () 
13 -SetText ("Fragment B") 


public void onCreate (Bundle savedInstanceState) { 


bar.setNavigationMode (ActionBar.NAVIGATICN MOIE TABS); 
bar.setDisplayOptions(0, ActionBar.DISELAY SHOW TTTIE); 


11 .setTabListener (new TabListener< AFragment^ ( 
this, "fa",AFragment.class))); 
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14 .setTabListener (new TabLi stener< BFragment^ ( 
this, "fb", BFragrent..class))); 
15 
16 if (savedInstanceState !- null) { 
17 bar.setSelectedNavigationTtem (savedInstanceState.getInt 
("tab", 0); 
18 ) 
19 ) 


代码 第 5 行 调用 getActionBar() 获 取 操作 栏 实 例 。 

代码 第 6 行将 操作 栏 的 导航 模式 设置 为 Tab 导航 栏 模式 ,NAVIGATION_MODE_ 
TABS 常量 的 值 为 2, 还 支持 的 常量 包括 NAVIGATION_MODE_LIST( 值 为 1) 和 
NAVIGATION_MODE_STANDARD( 值 为 0) ,分 别 表示 列表 导航 栏 和 标准 导航 栏 。 

代码 第 7 行 用 来 设置 操作 栏 的 显示 选项 。setDisplayOptions(int options. int mask) 
函数 的 options 参数 表示 显示 的 内 容 , 而 mask 参数 则 表示 不 显示 的 内 容 。 第 7 行 代 码 的 
意思 是 关闭 “显示 标题 文字 (DISPLAY_SHOW_TITLE)”。setDisplayOptions() 函数 支 
持 的 常量 如 表 5.4 所 示 。 


35.4. setDisplayOptions() 函 数 支 持 的 常量 


E 量 值 说 M 
DISPLAY_HOME_AS_UP 4 在 Home 元 素 左 侧 显示 回 退 按钮 
DISPLAY_SHOW_CUSTOM 16 显示 自 定义 视图 
DISPLAY_SHOW_HOME 2 在 操作 栏 中 显示 Home 元 素 
DISPLAY_SHOW_TITLE 8 显示 Activity 的 标题 
DISPLAY USE LOGO 1 使 用 Logo 代替 程序 图 标 


代码 第 9 行使 用 add() 函数 添加 Tab 页 ,代码 第 10 行 设置 Tab 页 的 标题 ,代码 第 11 
行 定义 这 是 Tab 页 点 击 事件 的 监听 函数 。 

代码 第 16 行 和 第 17 行 , 表 明 如 果 Activity 不 是 首次 启动 , 则 在 savedInstanceState 
变量 中 获取 当前 Tab 页 的 索引 号 。 

onSaveInstanceState ) 函数 在 Activity 临时 推出 时 ,将 当前 Tab 页 的 索引 号 保存 在 
Bundle 中 ,代码 如 下 。 


@ Override 
protected void onSaveInstanceState (Bundle outState) ( 
super.onSaveInstanceState (outState) ; 
cutState.putInt ("tab", get2cticrBar () .getSelectedNavigationIndex () ) ; 
H 


C o4 0 To nm 


构造 Tab 导航 栏 的 事件 监听 函数 ,必须 实现 ActionBar. TabListener 接口 ,主要 是 实 
现 接 口中 的 3 个 函数 .分别 是 onTabSelected () .onTabUnselected O 和 onTabReselected O 。 
onTabSelected() 在 当前 Tab 页 被 选中 时 调用 ,onTabUnselected() 在 其 他 Tab 页 被 选中 
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时 调用 ,onTabReselected() 在 当前 Tab 页 被 再 次 选中 时 调用 。 
静态 类 TabListener 的 代码 如 下 。 


B t5 


BRBREBBB 


B 


umwuueusnnsg 


Public static class TioListener« T extends Fragrent^ implements ActionBar 
.TabListener ( 

private final Activity mActivity; 

private final String niTag; 

private final Class« T^ nClass; 

private final Bundle mArgs; 

private Fragment mFragment; 


pblic TibListener (Activity activity, String tag, Classc T> clz) ( 
this(activity, tag, clz, null); 


public TabLi stener (Activity activity, String tag, Class« T» clz, 
Bundle args) ( 

mctivity= activity; 

Tag- tag; 

nClass- clz; 

márgs- args; 


mEragnent- mactivity.getFragmentManager () 

-findFragrentByTag (nTag) ; 

if (mEragment !- null && ImEragment.isDetached()) { 
FragrentTransaction ft- mActivity.getFragrentManager () 
-beginTransaction(); 
ft.detach (mEragrent) ; 


ft.ommit (); 


public void onTabSelected(Tab tab, FragmentTransaction ft) ( 


mEragment- Fragment .instantiate (mActivity, mClass 
-getName () , mArgs); 
ft.add(android.R.id.content, mEragment, milag); 
} else { 
ft.attach (mFragment) ; 


public void onTabUnselected(Tab tab, FragmentTransaction ft) ( 
if (mEragment '—null) ( 
ft.detach (mFragrent) ; 
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38 ) 

39 } 

40 

a public void onTabReselected (Tab tab, FragrentTransaction ft) { 

42 Toast.makeText (mActivity, "Reselected!", Toast.IENGTH - 
SHORT) .show()7 

43 ) 

44 } 


FragmentTransaction 封装 了 Fragment 变换 所 要 用 的 函数 ,包括 将 Fragment 加 入 
到 Activity 的 addO K% K Fragment 从 当前 界面 分 离 的 Detach O PR Zt. f 9E Detach() 
函数 分 离 的 Fragment 重新 连接 到 界面 的 attach O PRÉC. 

上 面 的 代码 具有 一 定 的 难度 ,部 分 内 容 涉及 Java 泛 型 编程 的 内 容 , 例 如 代码 第 1 行 
和 第 12 行 ,读者 可 以 参考 Java 语言 的 相关 资料 。 
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在 Android 系统 中 ,存在 多 种 界面 事件 ,如 点 击 事件 .触摸 事件 、 焦 点 事件 和 菜单 事 
件 等 ,在 这 些 事件 发 生 时 ,Android 界面 框架 调用 界面 控件 的 事件 处 理 函 数 对 事件 进行 
处 理 。 


561 按键 事件 


在 MVC 模型 中 ,控制 器 根据 界面 事件 (UI Event) 类 型 不 同 ,将 事件 传递 给 界面 控件 
不 同 的 事件 处 理 函 数 。 例 如 按键 事件 (KeyEvent) 将 传递 给 onKey O 函数 进行 处 理 , 触 摸 
事件 (TouchEvent) 将 传递 给 on Touch O PR Zi JE £7 Ab FB, 

Android 系统 界面 事件 的 传递 和 处 理 遵循 一 定 的 规则 。 首 先 ,如 果 界 面 控件 设置 了 
事件 监听 器 , 则 事件 将 先 传递 给 事件 监听 器 ;相反 ,如 果 界 面 控件 没有 设置 事件 监听 器 ， 
界面 事件 则 会 直接 传递 给 界面 控件 的 其 他 事件 处 理 函 数 。 即 使 界面 控件 设置 了 事件 监 
听 器 ,界面 事件 也 可 以 再 次 传递 给 其 他 事件 处 理 函 数 ,是 否 继续 传递 事件 给 其 他 处 理 函 
数 是 由 事件 监听 器 处 理 函 数 的 返回 值 决定 的 。 如 果 监 听 器 处 理 函 数 的 返回 值 为 true, W 
表示 该 事件 已 经 完成 处 理 过 程 ,不 需要 其 他 处 理 函 数 参 与 处 理 过 程 ,这 样 事件 就 不 会 再 
继续 进行 传递 。 反 之 ,如 果 监 听 器 处 理 函 数 的 返回 值 为 false, 则 表示 该 事件 没有 完成 处 
理 过 程 ,或 需要 其 他 处 理 函 数 捕获 到 该 事件 ,事件 会 传递 给 其 他 的 事件 处 理 函 数 。 

Fifi] EditText 控件 中 的 按键 事件 为 例 说 明 Android 系统 界面 的 事件 传递 和 处 理 
过 程 ,假设 EditText 控件 已 经 设置 了 按键 事件 监听 器 。 当 用 户 按 下 键盘 上 的 某 个 按键 
时 ,控制 器 将 产生 KeyEvent 按键 事件 。Android 系统 会 首先 判断 EditText 控件 是 否 设 
置 了 按键 事件 监听 器 ,因为 EditText 控件 已 经 设置 按键 事件 监听 器 OnKeyListener. Br 
以 按键 事件 先 传递 到 监听 器 的 事件 处 理 函 数 onKey() 中 。 事 件 是 否 能 够 继续 传递 给 


N 
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EditText 控件 的 其 他 事件 处 理 函 数 .完全 根据 onKey() 函 数 的 返回 值 来 确定 。 如 果 
onKey O 函数 返回 false, 事 件 将 继续 传递 ,这 样 Edit Text 控件 就 可 以 捕获 该 事件 ,将 按键 
的 内 容 显 示 在 EditText 控件 中 。 如 果 onKey O ERGR [8] true, 将 阻止 按键 事件 的 继续 传 
递 , 这 样 EditText 控件 就 不 能 够 捕获 到 按键 事件 ,也 就 不 能 够 将 按键 内 容 显 示 在 
EditText 控件 中 。 

Android 界面 框架 支持 对 按键 事件 的 监听 ,并 能 够 将 按键 事件 的 详细 信息 传递 给 处 理 
函数 。 为 了 处 理 控件 的 按键 事件 , 先 需要 设置 按键 事件 的 监听 器 ,并 重 载 onKeyO 〇 函数。 示 
例 代码 如 下 。 


1 entryText .setOnKeyListener (new OnKeyListener () ( 

2 G Override 

3 public boolean onKey (View view, int keyCode, KeyEvent keyEvent) ( 
4 // 过 程 代码 … 

5 return true; //or false; 

6 ) 


第 1 行 代码 是 设置 控件 的 按键 事件 监听 器 。 在 代码 第 3 行 的 onKey O RAOR, 06 
1 个 参数 view 表示 产生 按键 事件 的 界面 控件 ;第 2 个 参数 keyCode 表示 按键 代码 ;第 3 
个 参数 keyEvent 则 包含 了 事件 的 详细 信息 ,如 按键 
的 重复 次 数 、 硬 件 编码 和 按键 标志 等 。 第 5 行 是 
onKey O 函数 的 返回 值 ,返回 true, 阻 止 事件 传递 ; 返 
回 false, 允许 继续 传递 按键 事件 。 

KeyEventDemo 是 一 个 说 明 如 何 处 理 按键 事件 
的 示例 。 在 这 个 示例 中 ,用 户 界面 如 图 5. 43 所 示 。 

在 KeyEventDemo 的 用 户 界面 中 ,最 上 方 的 
EditText 控件 是 输入 字符 的 区 域 ,中 间 的 CheckBox 
控件 用 来 控制 onKey O 函数 的 返回 值 ,最 下 方 的 
TextView 控件 用 来 显示 按键 事件 的 详细 信息 ,包括 
按键 动作 ,按键 代 码 、 按 键 字符 、Unicode 编码 .重复 次 数 、 功 能 键 状 态 、 硬 件 编码 和 按键 
标志 o 


界面 的 XML 文件 的 代码 如 下 。 


| | KeyEventDemo 


a 


返回 true， 阻 止 将 按键 事件 传递 给 界面 
X 


图 5.43 KeyEventDemo 界面 


< EditText android:id- "8  id/entry" 
android:layout width- "fill parent" 
android:layout height- "wrap content" 
< /EditText> 
< CheckBox android:id- "@ + id/block" 
android:layout width- "wrap content" 
android:layout height- "wrap content" 
android:text- "返回 true, 阻 止 将 按键 事件 传递 给 界面 元 素 "> 
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< /CheckBox> 

< TextView android:id- "@ + id/label" 
android:layout width= "wrap content" 
android:layout height- "wrap content" 
android:text- "按键 事件 信息 "> 

< /TextView> 


在 EditText 中 ,每 当 任何 一 个 键 按 下 或 抬 起 时 ,都 会 引发 按键 事件 。 但 为 了 能 够 使 
EditText 处 理 按键 事件 ,需要 使 用 setOnKeyListener() 函 数 在 代码 中 设置 按键 事件 监听 


器 ,并 在 onKey() 函 数 添加 按键 事件 的 处 理 过 程 。 


1 
2 
3 
4 
5 
6 
7 
8 
9 


entryText .setOnKeyListener (new OnKeyListener () ( 
@ Override 
public boolean ankey (View view, int keyCode, KeyEvent keyEvent) ( 


int metaState- keyEvent .getMetaState () ; 
int unicodeChar- keyEvent..getUnicodeChar () ; 
String msg- ""; 
mgr = "按键 动作 :"+ String.valueof (keyEvent .getAction())+ "An"; 
megt = "flc HEARTS :"+ String.valueof (keyCode)+ "yn"; 
msgt= "ik fil F fF :"+ (char)unicodecharr "\n"; 
msg+= "UNIOODE: "+ String.valueOf (unicodeChar)+ "An"; 
megt =" 重 复 次 数 :"+ String. valueof (esEvent..getFepeatOaant () ) "n"; 
msg+= "功能 键 状态 :"+ String.valueof (metaState) "\n"; 
megt = "fil (^F 4i i :"+ String.valueof (keyEvent .getScanCode())+ "n"; 
mogt = "按键 标志 :"+ String.valueof (keyEvent .getFlags ())+ "An"; 
labelView.set'Text (msg) 7 
if (checkBox.ischecked()) 
retur true; 
else 
return false; 
} 


第 4 行 代码 用 来 获取 功能 键 状态 。 功 能 键 包括 左 AlcRE T? Alt 键 和 Shift 键 , 当 这 
三 个 功能 键 被 按 下 时 ,功能 键 代码 metaState 值 分 别 为 18、34 和 65; 但 没有 功能 键 被 按 下 
时 ,功能 键 代码 metaState 值 为 0。 第 5 行 代码 获取 了 按键 的 Unicode 值 ,在 第 9 行 中 ,将 
Unicode 转换 为 字符 ,显示 在 TextView 中 。 第 7 行 代码 获取 了 按键 动作 ,0 表示 按 下 按 
键 ,1 表示 抬 起 按键 。 第 7 行 代码 获取 按键 的 重复 次 数 ,但 按键 被 长 时 间 按 下 时 , 则 会 产 
生 这 个 属性 值 。 第 13 行 代码 获取 了 按键 的 硬件 编码 ,不 同 硬件 设备 的 按键 硬件 编码 都 


不 相同 ,因此 该 值 一 般 用 于 调试 。 第 14 行 获取 了 按键 事件 的 标志 种 
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伴随 着 触摸 屏 的 普及 ,手机 的 操作 方式 也 随 之 改变 ,用 户 已 经 不 满足 键盘 的 操作 方 
式 , 而 是 更 加 倾心 于 使 用 手指 在 屏幕 上 进行 操作 。 

Android 界面 框架 支持 对 触摸 事件 的 监听 ,并 能 够 将 触摸 事件 的 详细 信息 传递 给 处 理 
函数 。 为 了 处 理 控件 的 触摸 事件 ,首先 需要 设置 触摸 事件 的 监听 器 ,并 重 载 on Touch O PR 
数 ,示例 代码 如 下 。 


1 toudhView.setonTouchLi stener (new View.OnTouchListener () { 
2 @ Override 

3 public boolean onTouch (View v, MotionEvent event) { 
4 // 过 程 代码 … 

5 return true/false; 

6 ) 


第 1 行 代码 是 设置 控件 的 触摸 事件 监听 器 。 在 代码 第 3 行 的 onTouch O RXR , 9 
1 个 参数 View 表示 产生 触摸 事件 的 界面 控件 ;第 2 个 参 
数 MotionEvent 是 触摸 事件 的 详细 信息 ,如 产生 时 间 , A | Toucheventpem。 
标 和 触 点 压力 等 。 第 5 行 是 onTouch() 函 数 的 返回 值 。 ”上 R 

TouchEventDemo 是 一 个 说 明 如 何 处 理 触 摸 事 件 的 
示例 。 在 这 个 示例 中 ,用 户 界面 如 图 5.44 所 示 。 

在 TouchEventDemo 的 用 户 界面 中 ,上 方 浅 色 区 域 
是 可 以 接受 触摸 事件 的 区 域 ,用 户 可 以 在 Android 模拟 
器 中 使 用 鼠标 点 击 屏幕 ,用 以 模拟 触摸 手机 屏幕 。 下 方 
黑色 区 域 是 显示 区 域 ,用 来 显示 触摸 事件 的 类 型 .相对 坐 
标 、 绝 对 坐标 、 触 点 压力 、 触 点 尺寸 和 历史 数据 量 等 信息 。 

在 用 户 界 面 中 使 用 了 线性 布局 ,并 加 入 了 3 个 
TextView 控件 ,第 1 个 TextView(ID 为 touch_area) 用 5.44 TouchEventDemo 界面 
来 标识 触摸 事件 的 测试 区 域 , 第 2 个 TextView AD 为 
history_label) 用 来 显示 触摸 事件 的 历史 数据 量 , 第 3 个 TextView(ID 为 event_label) 用 
来 显示 触摸 事件 的 详细 信息 ,包括 类 型 .相对 坐标 ,绝对 坐标 、 触 点 压力 和 触 点 尺寸 。 
XML 文件 的 代码 如 下 。 


< ?xml version "1.0" encoding- "utf- 8"?> 
< LinearTayout xmins:android= "http://scheras. android. oa/apk/res/android" 
android:orientation- "vertical" 
android:layout width- "fill parent" 
android:layout height= "fill parent'- 
< TextView android:id- "@ id/touch area" 
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7 android:layout width- "fill parent" 
android:layout height "300dip" 

9 android:background- " 80A0FF" 

10 android:textColor- "# FFFFFF" 

n android:text- "fth £ E PHW iX [X 1 "> 

12 < /TextView> 

13 < TextView android:id- "@ + id/history label" 

14 android:layout width "wrap content" 

15 android:layout height- "wrap content" 

16 android:text- "历史 数据 量 : "> 

17 < /TextView> 

18 < TextView android:id- "@ + id/event. label" 

19 android:layout width- "wrap content" 

20 android:layout height- "wrap content" 

2 android:text= "fph fft E ff : "> 

22 < /TextView> 

23  «/Linearlayout^ 


上 面 的 代码 中 ,第 9 行 定义 了 TexiView 的 背景 颜色 ,#80AOFF 是 颜色 代码 。 第 10 
行 定 义 了 TextView 的 字体 颜色 。 
在 代码 中 为 了 能 够 引用 XML 文件 中 声明 的 界面 元 素 , 使 用 了 下 面 的 代码 。 


TextView labelView- null; 

labelView- (TextView)findViewById(R.id.event label); 

TextView touctView- (TextView)findViewById(R.id.touch area); 

final TextView historWiew- (IextView) fincViesById(R.id.history label); 


X 


当 手 指 接触 到 触摸 屏 、 在 触摸 屏 上 移动 或 离开 触摸 屏 时 ,分 别 会 引发 ACTION 
DOWN,ACTION UP 和 ACTION MOVE 和 触摸 事件 ,而 无 论 是 哪 种 触摸 事件 ,都 会 调 
用 onTouch() 函 数 进行 处 理 。 事 件 类 型 包含 在 onTouch() 函数 的 MotionEvent 参数 中 ， 
可 以 通过 getAction O 函数 获取 到 触摸 事件 的 类 型 ,然后 根据 触摸 事件 的 不 同类 型 进行 
不 同 的 处 理 。 但 为 了 能 够 使 屏幕 最 上 方 的 TextView 处 理 触 摸 事件 ,需要 使 用 
setOnTouchListener O 函数 在 代码 中 设置 触摸 事件 监听 器 ,并 在 on Touch O 函数 添加 触 
摸 事 件 的 处 理 过 程 。 


touchView.setOnTouchListener (new View.OnTouchListener (){ 
@ Override 
public boolean anTouch (View v, MotionEvent event) { 
int action- event.getAction(); 
Switch (action) ( 
case (MotionEvent.ACTION DOWN): 
Display ("ACTION DOWN",event); 
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8 break; 

9 case (MotionEvent.ACTION UP): 

10 int historySize- ProoessHi story (event) ; 
n historWiew.set'Text ("历史 数据 量 : "e historysize); 
12 Display ("ACTION UP",event) ; 

13 break; 

14 case (MotionEvent.ACTION MWE) : 

15 Display ("ACTION MWE", event) ; 

16 break; 

17 ) 

18 retum true; 

19 ) 

20 n: 


58 7 行 代码 的 DisplayOZé— A H XE XC R, E 92 HH oe Sj on fb 15 38 PE DA V IU fei I. PRI 
数 的 代码 和 含义 将 在 后 面 进 行 介绍 。 第 10 行 代码 的 ProcessHistory() 也 是 一 个 自 定义 
函数 ,用 来 处 理 触摸 事件 的 历史 数据 ,也 是 在 后 面 进行 介绍 。 第 11 行 代码 是 使 用 
TextView 显示 历史 数据 的 数量 。 

MotionEvent 参数 中 不 仅 有 触摸 事件 的 类 型 信息 ,还 有 触 点 的 坐标 信息 ,获取 方法 是 
使 用 getX() 和 gec Y O 函数 ,这 两 个 函数 获取 的 是 触 点 相对 于 父 界面 元 素 的 坐标 信息 。 
如 果 需 要 获取 绝对 坐标 信息 , 则 可 使 用 getRawX() 和 getRawY( 〇 函数 。 触 点 压力 是 一 个 
介 于 0 和 1 之 间 的 浮 点 数 , 用 来 表示 用 户 对 触摸 屏 施 加 压力 的 大 小 ,接近 0 表示 压力 较 
小 ,接近 1 表示 压力 较 大 ,获取 触摸 事件 触 点 压力 的 方式 是 调用 getPressure O KX fth 
点 尺寸 指 用 户 接触 触摸 屏 的 接触 点 大 小 ,也 是 一 个 介 于 0 和 1 之 间 的 浮 点 数 ,接近 0 表示 
尺寸 较 小 ,接近 1 表示 尺寸 较 大 ,可 以 使 用 getSize() 函 数 获取 。 

Display() 将 MotionEvent 参数 中 的 事件 信息 提取 出 来 ,并 显示 在 用 户 界面 上 。 


1 private void Display (String eventType, MotionEvent event) { 
2 int x- (int)event.getX() ; 

3 int y= (int)event.getY (); 

4 float pressure- event .getPressure () ; 

5 float size- event.getSize(); 

6 int RawX- (int)event.getRawX () ; 

7 int RawY- (int)event.getRawY(); 

8 
9 


String msg- ""; 
10 msgt — "PFA : "+ eventTypet "n"; 
u megt=" 相 对 坐标 : "+ String.valueOf (x)+ ","+ String.valueof (y)+ "An" 
12 megt — "A6 X. AI : "+ Sccing.valueOf (Fas) - ","+ String.valueOf (Raw) - 
"n"; 
13 msg+= "fih ài FR J] : "+ String.valueOf (pressure)t ", "; 


14 msgt+=" 触 点 尺寸 : "+ String.valueof (size) "An"; 
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15 labelView.setText (msg) ; 


一 般 情 况 下 ,如 果 用 户 将 手指 放 在 触摸 屏 上 ,但 不 移动 ,然后 抬 起 手指 ,应 先后 产生 
ACTION_DOWN 和 ACTION_UP 两 个 触摸 事件 。 但 如 果 用 户 在 屏幕 上 移动 手指 ,然后 
再 抬 起 手指 , 则 会 产生 事件 序列 : ACTION. DOWN— ACTION. MOVE > ACTION _ 
MOVE—>ACTION_MOVE—>…>ACTION_UP. 

在 手机 上 运行 的 应 用 程序 ,效率 是 非常 重要 的 。 如 果 Android 界面 框架 不 能 产生 足 
够 多 的 触摸 事件 , 则 应 用 程序 就 不 能 够 很 精确 地 描绘 触摸 屏 上 的 触摸 轨迹 。 相 反 , 如 果 
Android 界面 框架 产生 了 过 多 的 触摸 事件 ,虽然 能 够 满足 精度 的 要 求 ,但 却 降低 了 应 用 程 
序 的 效率 。Android 界面 框架 使 用 了 “打包 ”的 解决 方法 。 在 触 点 移动 速度 较 快 时 会 产生 
大 量 的 数据 ,每 经 过 一 定 的 时 间 间 隔 便 会 产生 一 个 ACTION. MOVE 事件 ,在 这 个 事件 
中 ,除了 有 当前 触 点 的 相关 信息 外 ,还 包含 这 段 时 间 间 隔 内 和 触 点 轨迹 的 历史 数据 信息 ,这 
样 既 能 够 保持 精度 ,又 不 至 于 产生 过 多 的 触摸 事件 。 通 常情 况 下 ,在 ACTION MOVE 
的 事件 处 理 函数 中 ,都 先 处 理 历史 数据 ,然后 再 处 理 当 前 数据 。 


1 private int ProcessHistory (MotionEvent event) 

2 t 

3 int historySize- event.getHistorySize(); 

4 for (int i-0; i«historySize; it*) ( 

5 long time- event .getHistoricalEventTime (i); 

6 float pressure- event..getHistoricalPressure (i); 
7 float x- event .getHistoricalX (i); 

8 float y= event .getHistoricaly (i); 

9 float size- event.getHistoricalSize (i); 

10 


n // 处 理 过 程 … 
12 } 
13 retum historySize; 


14 ] 


在 ProcessHistory() 函 数 中 ,第 3 行 代码 获取 了 历史 数据 的 数量 ,然后 在 第 4 行 至 第 
12 行 中 循环 处 理 这 些 历 史 数据 。 第 5 行 代码 获取 了 历史 事件 的 发 生 时 间 , 第 6 行 代码 获 
取 历 史 事 件 的 触 点 压力 ,第 7 行 和 第 8 行 代码 获取 历史 事件 的 相对 坐标 ,第 9 行 获取 历史 
事件 的 触 点 尺寸 。 在 第 13 行 返 回 历史 数据 的 数量 ,主要 是 用 于 界面 显示 o 

Android 模拟 器 并 不 支持 触 点 压力 和 触 点 尺寸 的 模拟 ,所 有 触 点 压力 恒 为 1.0, 触 点 
尺寸 恒 为 0.0。 同 时 ,在 Android 模拟 器 上 也 无 法 产生 历史 数据 ,因此 历史 数据 量 一 直 显 
示 为 0。 
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l. 简 述 6 种 界面 布局 的 特点 。 
2. 参考 图 5. 45 中 界面 控件 的 摆 放 位 置 ,使 用 多 种 布局 方法 实现 用 户 界面 ,并 对 比 各 
种 布局 实现 的 复杂 程度 和 对 不 同 屏幕 尺寸 的 适应 能 力 。 


jimmy 


.1 


添加 数 。 全 部 显 ”清除 显 2MM 
据 示 示 除 


图 5.45 使 用 多 种 布局 方法 实现 用 户 界面 


3. 简 述 Android 系统 三 种 菜单 的 特点 及 其 使 用 方式 。 
4. 说 明 使 用 操作 栏 为 程序 开发 带 来 的 便利 。 


E Ü ER cheer [Ss — 000. 
组 件 通信 与 广播 消息 


Intent 是 一 种 消息 传递 机 制 , 用 于 组 件 之 间 数 据 交 换 和 发 送 广播 消息 。 通 过 本 章 的 
学 习 可 以 让 读者 了 解 Android 系统 的 组 件 通信 原理 ,掌握 利用 Intent 启动 其 他 组 件 的 方 
法 ,以 及 利用 Intent 获取 信息 和 发 送 广播 消息 的 方法 。 

本 章 学 习 目 标 : 

。 了 解 使 用 Intent 进行 组 件 通 信 的 原理 ; 

。 掌握 使 用 Intent 启动 Activity 的 方法 ; 

。 掌握 获取 Activity 返回 值 的 方法 ; 

。 了 解 Intent 过 滤器 的 原理 与 匹配 机 制 ; 

。 掌握 发 送 和 接收 广播 消息 的 方法 。 


61 Intent 简介 


Intent 是 一 种 轻 量 级 的 消息 传递 机 制 ,可 以 在 同一 个 应 用 程序 内 部 的 不 同 组 件 之 间 
传递 信息 ,也 可 以 在 不 同 应 用 程序 的 组 件 之 间 传 递 信息 ,还 可 以 作为 广播 事件 发 布 
Android 系统 消息 。 由 于 Intent 的 存在 ,使 得 Android 系统 中 互相 独立 的 组 件 成 为 可 以 
互相 通信 的 组 件 集合 。 因 此 ,无 论 这 些 组 件 是 否 在 同一 个 应 用 程序 中 ,Intent 都 可 以 将 一 
个 组 件 的 数据 或 动作 传递 给 另 一 个 组 件 。 

Intent 是 一 个 动作 的 完整 描述 ,包含 了 动作 的 产生 组 件 .接收 组 件 和 所 传递 的 数据 信 
息 ,接收 组 件 在 接收 到 Intent 所 传递 的 消息 后 ,会 执行 相应 的 动作 。 因 此 ,Intent 可 以 非 
常 方便 地 启动 其 他 组 件 , 如 启动 Activity 或 Service, Intent 支持 显 式 启动 或 隐 式 启动 组 
件 ,显示 启动 需要 指明 须要 加 载 组 件 的 类 , 隐 式 启动 则 无 须 指 明 具 体 的 类 ,只 要 提供 需要 
处 理 的 数据 或 动作 即 可 。 隐 式 启 动 的 好 处 是 不 必 与 某 个 具体 的 组 件 耦 合 ,降低 了 
Android 系统 中 组 件 之 间 的 耦合 度 . 有 利于 组 件 分 离 , 并 允许 无 颖 地 替换 应 用 程序 中 的 
元 素 。 

Intent 的 另 一 个 用 途 是 在 Android 系统 上 发 布 广播 消息 。 广 播 消 息 可 以 是 程序 的 内 
部 消息 ,可 以 是 第 三 方程 序 发 出 的 消息 ,也 可 以 是 Android 系统 消息 ,如 手机 的 信号 变化 
或 电池 的 电量 过 低 等 信息 。 任 何 程序 都 可 以 根据 需要 发 布 广播 消息 ,其 他 程序 也 可 以 通 
过 注册 Intent 过 滤器 获得 这 些 广 播 消 息 。 
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611 启动 Acivty 

在 Android 系统 中 ,应 用 程序 一 般 都 有 多 个 Activity, Intent 可 以 实现 不 同 Activity 
之 间 的 切换 和 数据 传递 。Intent 启动 Activity 的 方式 可 以 分 为 显 式 启动 和 隐 式 启动 。 显 
式 启动 必须 在 Intent 中 指明 启动 Activity 所 在 的 类 ,而 隐 式 启动 则 由 Android 系统 , 根 
据 Intent 的 动作 和 数据 来 决定 启动 哪 一 个 Activity。 也 就 是 说 隐 式 启动 时 ,Intent 中 只 
包含 需要 执行 的 动作 和 所 包含 的 数据 ,而 无 须 指明 具体 启动 哪 一 个 Activity, 选 择 权 由 
Android 系统 和 最 终 用 户 来 决定 。 


1l. 显 式 启动 


使 用 Intent 来 显 式 启动 Activity, 首 先 需 要 创建 一 个 Intent, 并 为 它 指定 当前 的 应 用 程 
序 上 下 文 以 及 要 启动 的 Activity, 把 创建 好 的 这 个 Intent 作为 参数 传递 给 startActivity() 
方法 。 


1 Intent intent- new Intent (IntentDemb.this, ActivityToStart.class); 
2 StartActivity (intent); 


下 面 用 IntentDemo 示例 说 明 如 何 使 用 Intent 启动 新 的 Activity; IntentDemo 示例 
包含 两 个 Activity. 分 别 是 IntentDemoActivity 和 NewActivity。 程 序 默 认 启 动 的 
Activity 是 IntentDemo, TE H] P! 4 if; “Ja lj. Activity” 按 钮 后 ,程序 启动 的 Activity 是 
NewActivity, 如 图 6. 1 所 示 。 


[| IntentDemo 


启动 Activity 


{a) IntentDemoActivity (b) NewActivity 


6.1 IntentDemo 示例 用 户 界面 
在 IntentDemo 示例 中 使 用 了 两 个 Activity, 因 此 需要 在 AndroidManifest. xml 文件 中 注 


册 这 两 个 Activity。 注 册 Activity 应 使 用 二 activity 二 标签 , 嵌 套 在 二 application 二 标签 内 部 。 
AndroidManifest. xml 文件 代码 如 下 。 


< ?xml version= "1.0" encoding- "utf- 8"?> 
«manifest xmlns:android- "http: //schemas .android.oawapk/res/android" 
package- "edu. hrbeu. IntentDero" 
android:versionCode- "1" 
android:versionName- "1.0" 


oO 0 5 QU I | 


« application android:icon- "8 drawable/icon" android:label- 
"Q string/app name" 
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E < activity android:name- ".IntentDemo" 
android:label- "8 string/app name" 
9 < intent- filter» 
10 <action android:name- "android.intent.action.MATN"/» 
11 < category android:name- "android.intent.category 
-IAUNCHER"/^ 
12 < /intent- filter» 
13 < /activity> 
14 < activity android:name- ".NewActivity" 
15 android:label- "8 string/app name" 
16 < /activity> 
17 < /application> 
18 < uses- sdk android:minSdkVersion- "14"/> 
19  «/manifest^ 


Android 应 用 程序 中 ,用 户 使 用 的 每 个 组 件 都 必须 在 AndroidManifest. xml 文件 中 
的 二 application 之 节点 内 定义 。 在 上 面 的 代码 中 ,一 application 二 节点 下 共有 两 个 
<activity 过 节点 ,分 别 代表 应 用 程序 中 所 使 用 的 两 个 Activity: IntentDemoActivity 和 
NewActivity。 


在 IntentDemoActivity. java 文件 中 ,包含 了 使 用 Intent 启动 Activity 的 核心 代码 。 


1 Button button- (Button) findViewById(R.id.btn); 

2 button.setOnClickListener (new OnClickListener () ( 

3 public void onClick (View view) { 

4 Intent intent- new Intent (IntentDemoActivity.this, NewActivity 

.Class); 
5 startActivity (intent); 
) 
了 ni 
在 点 击 事件 的 处 理 函 数 中 ,Intent 构造 函数 的 第 1 个 参数 是 应 用 程序 上 下 文 , 在 这 里 

就 是 IntentDemoActivity; 第 2 个 参数 是 接收 Intent 的 目标 组 件 , 这 里 使 用 的 是 显 式 启动 


方式 ,直接 指明 了 需要 启动 的 Activity。 
2. 隐 式 启动 


隐 式 启动 的 好 处 在 于 不 需要 指明 需要 启动 哪 一 个 Activity, 而 由 Android 系统 来 决 
定 , 这 样 有 利于 降低 组 件 之 间 的 耦合 度 。 

隐 式 启动 Activity 时 ,Android 系统 会 在 程序 运行 时 解析 Intent, 并 根据 一 定 的 规则 
对 Intent 和 Activity 进行 匹配 ,使 Intent. 上 的 动作 数据 与 Activity 完全 吻合 。 匹 配 的 
组 件 可 以 是 程序 本 身 的 Activity, 也 可 以 是 Android 系统 内 置 的 Activity, 还 可 以 是 第 三 
方 应 用 程序 提供 的 Activity。 因 此 ,这 种 方式 强调 了 Android 组 件 的 可 复 用 性 。 


134 


A (第 2 版 ) 


例如 ,如 果 程序 开发 人 员 和 希望 启动 一 个 浏览 器 ,查看 指定 的 网 页 内 容 , 却 不 能 确定 具 
体 应 该 启动 哪 一 个 Activity, 此 时 则 可 以 使 用 Intent 的 隐 式 启动 方式 ,由 Android 系统 在 
程序 运行 时 决定 具体 启动 哪 一 个 应 用 程序 的 Activity 来 接收 这 个 Intent。 程 序 开发 人 员 
可 以 将 浏览 动作 和 Web 地 址 作为 参数 传递 给 Intent. Android 系统 则 通过 匹配 动作 和 数 
据 格 式 ,找到 最 适合 于 此 动作 和 数据 格式 的 组 件 。 


1 Intent intent- new Intent (Intent.ACTION VIEW, Uri.parse("http://www. 
google.com.hk")) ; 
2 startActivity (intent); 


Intent 的 动作 是 Intent. ACTION |. VIEW. 数据 是 Web 地 址 ,使 用 Uri. parse 
(CurlString) 方 法 ,可 以 简单 地 把 一 个 字符 串 解释 成 Uri 对 象 。Android 系统 在 匹配 Intent 
时 ,首先 根据 动作 Intent. ACTION. VIEW ,得 知 需 要 启动 具备 浏览 功能 的 Activity [HR 
体 是 浏览 电话 号 码 还 是 浏览 网 页 ,还 需要 根据 URI 的 数据 类 型 来 做 最 后 判断 。 因 为 数据 
提供 的 是 Web 地 址 "http://www. google. com" ,所 以 最 终 可 以 判定 Intent 需要 启动 具 
有 网 页 浏览 功能 的 Activity。 在 默认 情况 下 ,Android 系统 会 调用 内 置 的 Web 浏览 器 。 

Intent 的 语法 如 下 。 


Intent intent- new Intent (Intent.ACTTON VIEW, Uri.parse (urlString)); 


Intent 构造 函数 的 第 1 个 参数 是 Intent 需要 执行 的 动作 ,Android 系统 支持 的 常见 
动作 字符 串 常 量 可 以 参考 表 6.1。 第 2 个 参数 是 URI, 表 示 需 要 传递 的 数据 。 
3X 6.1 Intent 常用 动作 
说 明 
打开 接听 电话 的 Activity, 默 认为 Android 内 置 的 拨号 界面 
打开 拨号 盘 界 面 并 拨打 电话 ,使 用 Uri 中 的 数字 部 分 作为 电话 号 码 


动 作 
ACTION_ANSWER 


ACTION_CALL 


ACTION_DELETE 


打开 一 个 Activity, 对 所 提供 的 数据 进行 删除 操作 


ACTION_DIAL 


打开 内 置 拨号 界面 ,显示 Uri 中 提供 的 电话 号 码 


ACTION_EDIT 


打开 一 个 Activity, 对 所 提供 的 数据 进行 编辑 操作 


ACTION_INSERT 


打开 一 个 Activity, 在 提供 数据 的 当前 位 置 插入 新 项 


ACTION_PICK 


启动 一 个 子 Activity, 从 提供 的 数据 列表 中 选取 一 项 


ACTION_SEARCH 


启动 一 个 Activity, 执 行 搜索 动作 


ACTION_SENDTO 


启动 一 个 Activity, 向 数据 提供 的 联系 人 发 送信 息 


ACTION_SEND 


启动 一 个 可 以 发 送 数据 的 Activity 


ACTION VIEW 


最 常用 的 动作 ,对 以 Uri 方式 传送 的 数据 ,根据 Uri 协议 部 分 以 最 佳 方式 
启动 相应 的 Activity 进行 处 理 。 对 于 http: address 将 打开 浏览 器 查看 ; 
对 于 tel:address 将 打开 拨号 界面 并 呼叫 指定 的 电话 号 码 


ACTION WEB SEARCH 


打开 一 个 Activity, 对 提供 的 数据 进行 Web 搜索 
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WebViewIntentDemo 示例 说 明了 如 何 隐 式 启动 Activity, 用 户 界 面 如 图 6. 2(a) 所 示 。 


http://www.google.com.hk 


浏览 此 URL 


(a) 输入 网 址 界面 (b) 打 并 Web 后 的 界面 


图 6.2 WebViewIntentDemo 用 户 界面 


当 用 户 在 文本 框 中 输入 Web 地 址 后 ,通过 点 击 “ 浏 览 此 URL” 按 钮 ,程序 根据 用 户 输 
入 的 Web 地 址 生成 一 个 Intent, 并 以 隐 式 启动 的 方式 调用 Android 内 置 的 Web 浏览 器 ， 
并 打开 指定 的 Web 页 面 。 本 例 输入 的 Web 地 址 为 http://www. google. com. hk, 打 开 
页 面 后 的 效果 如 图 6.2(b) 所 示 。 


612 获取 Acivty 返回 值 


在 6. 1. 1 节 IntentDemo 示例 中 ,通过 startActivity(Intent) 方 法 启动 Activity, 启 动 
后 的 两 个 Activity 相互 独立 ,没有 任何 的 关联 。 在 很 多 情况 下 ,后 启动 的 Activity 是 为 了 
让 用 户 对 特定 信息 进行 选择 ,在 后 启动 的 Activity 关闭 时 ,这 些 信 息 是 需要 返回 给 先前 
启动 的 Activity。 后 启动 的 Activity 称 为 “ 子 Activity”, 先 启动 的 Activity 称 为 “ 父 
Activity”。 如 果 需 要 将 子 Activity 的 信息 返回 给 父 Activity, 则 可 以 使 用 Sub-Activity 
的 方式 去 启动 子 Activity。 

获取 子 Activity 的 返回 值 ,一 般 可 以 分 为 三 个 步骤 ， 

(1) 以 Sub-Activity 的 方式 启动 子 Activity; 

(2) 设置 子 Activity 的 返回 值 ; 

(3) 在 父 Activity 中 获取 返回 值 。 

下 面 详细 介绍 每 一 个 步骤 的 过 程 和 代码 实现 。 


1. 以 Sub-Activity 的 方式 启动 子 Activity 


以 Sub-Activity 方式 启动 子 Activity. 需要 调用 startActivityForResult (Intent. 
requestCode) 函数 ,参数 Intent 用 于 决定 启动 哪个 Activity ,参数 requestCode 是 请 求 码 。 
因为 所 有 子 Activity 返回 时 , 父 Activity 都 调用 相同 的 处 理 函 数 ,因此 父 Activity 使 用 
requestCode 来 确定 数据 是 哪 一 个 子 Activity 返回 的 。 

显 式 启动 子 Activity 的 代码 如 下 。 


1 int SUBACTIVITYI- 1; 
p Intent intent- new Intent (this, SubActivityl.class); 
3 startActivityForResult (intent, SUBACTIVITY1); 
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隐 式 启动 子 Activity 的 代码 如 下 。 


int SUBACTIVITY2- 2; 

Uri uri- Uri .parse ("content.: //contacts/people") ; 
Intent intent- new Intent (Intent.ACTION PICK, uri); 
startActivityForResult (intent, SUBACTIVITY2); 


& 0o n 


2. 设置 子 Activity 的 返回 值 


ETF Activity 调用 finish O 函数 关闭 前 ,调用 setResult() 函 数 设 定 需 要 返回 给 父 
Activity 的 数据 。setResult() 函数 有 两 个 参数 ,一 个 是 结果 码 ,一 个 是 返回 值 。 结 果 码 表 
明子 Activity 的 返回 状态 ,通常 为 Activity. RESULT_OK( 正 常 返 回 数据 ) 或 者 Activity 
. RESULT_CANCELED( 取 消 返 回 数据 ) ,也 可 以 是 自 定义 的 结果 码 ,结果 码 均 为 整数 类 
型 。 返 回 值 封装 在 Intent 中 ,也 就 是 说 子 Activity 通过 Intent 将 需要 返回 的 数据 传递 给 
父 Activity。 数 据 主 要 以 Uri 形式 返回 给 父 Activity, 此 外 还 可 以 附加 一 些 额 外 信息 ,这 
些 额外 信息 用 Extra 的 集合 表示 。 

以 下 代码 说 明 如 何在 子 Activity 中 设置 返回 值 。 


Uri data= Uri.parse("tel:"* tel number); 
Intent result- new Intent (null, data); 
result.putExtra ("address", "JD Street"); 
setResult (RESULT CK, result); 

finish; 


[E PP 


3. 在 父 Activity 中 获取 返回 值 


当 子 Activity 关闭 后 , 父 Activity 会 调用 onActivityResult O) 函数 ,用 于 获取 子 
Activity 的 返回 值 。 如 果 需 要 在 父 Activity 中 处 理子 Activity 的 返回 值 , 则 重 载 此 函数 
即 可 。onActivityResult() 函数 的 语法 如 下 。 


pblic void orctivityResult (int reguestOode, int resultOode, Intent data); 


其 中 第 1 个 参数 requestCode 是 请 求 码 ,用 来 判断 第 3 个 参数 是 哪 一 个 子 Activity 的 返 
回 值 ;resultCode 用 于 表示 子 Activity 的 数据 返回 状态 ;Data 是 子 Activity 的 返回 数据 ， 
返回 数据 类 型 是 Intent。 根 据 返 回 数据 的 用 途 不 同 ,Uri 数据 的 协议 则 不 同 ,也 可 以 使 用 
Extra 方法 返回 一 些 原始 类 型 的 数据 。 

以 下 代码 说 明 如 何在 父 Activity 中 处 理子 Activity 的 返回 值 。 


A private static final int SUBACTIVITYI- 1; 
2 private static final int SUBACTIVITY2- 2; 
3 
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4 @ Override 

5  pilic void axctivityResult (int reguestOode, int resultOode, Intent data){ 
6 Super.onActivityResult (nequestCode, resultCode, data); 

7 switch (requestCode) ( 

8 case SUBACTIVITYl: 

9 if (resultCode- - Activity.RESULT OK)( 

10 Uri uriData- data.getData () ; 

1l Jelse if (resultOode- — Activity.RESULT CANCEL) ( 
12 ) 

13 break; 

14 case SUBACTIVITY2: 

15 if (resultCode- - Activity.RESULT OK) { 

16 Uri uriData- data.getData () ; 

17 } 

18 break; 

19 ) 

20 ] 


代码 的 第 1 行 和 第 2 行 是 两 个 子 Activity 的 请 求 码 ,在 第 7 行 对 请 求 码 进行 匹配 。 
代码 第 9 行 和 第 11 行 对 结果 码 进行 判断 ,如 果 返 回 的 结果 码 是 Activity. RESULT. OK. 
则 在 代码 的 第 10 行使 用 getData O 函数 获取 Intent 
中 的 Uri 数据 ;如 果 返 回 的 结果 码 是 Activity 
.RESULT_CANCELED, 则 放弃 所 有 操作 。 
启动 Activity1 ActivityCommunication 示例 说 明了 如 何以 Sub- 
Activity 方式 启动 子 Activity, 以 及 如 何 使 用 Intent 
进行 组 件 间 通信 。 
图 6.3 ActivityCommunication 该 示例 的 主 界面 如 图 6. 3 所 示 。 当 用 户 点 击 “ 启 
用 户 界面 动 Activity1” 和 “启动 Activity2” 按 钮 时 ,程序 将 分 别 
启动 子 SubActivityl 和 SubActivity2. 如 图 6. 4 所 
IRo SubActivityl 提供 了 一 个 输入 框 ,以 及 “接受 "和 “撤销 ”两 个 按钮 。 如 果 在 输入 框 中 
输入 信息 后 点 击 “ 接 受 " 按 钮 ,程序 会 把 输入 框 中 的 信息 传递 给 其 父 Activity, 并 在 父 
Activity 的 界面 上 显示 。 而 如 果 用 户 点 击 “ 撤 销 ” 按 钮 , 则 程序 不 会 向 父 Activity 传递 任 
何 信息 。SubActivity2 主要 是 为 了 说 明 如 何在 父 Activity 中 处 理 多 个 子 Activity, AE 
仅 提 供 了 用 于 关闭 SubActivity2 的 “关闭 ”按钮 。 
ActivityCommunication 示例 的 文件 结构 如 图 6. 5 所 示 , 父 Activity 的 代码 在 
ActivityCommunicationActivity. java 文件 中 ,界面 布局 在 main. xml 中 ;两 个 子 Activity 
的 代码 分 别 在 SubActivityl. java 和 SubActivity2. java 文件 中 ,界面 布局 分 别 在 


subactivityl. xml 和 subactivity2. xml 中 。 
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UŞ ActivityCommunication 
B src 
E edu.hrbeu.ActivityCommunication 

国 ActivityCommunicationActivityjava 
国 SubActivityljava 
国 SubActivity2java 

8 gen [Generated Java Files] 

BÀ Android 4.0 

Qs assets 

& bin 


tivityCommunication 


res 
© drawable-hdpi 
© drawable-ldpi 
© drawable-mdpi 
& layout 
国 mainxml 
国 subactivitylxml 
国 subactivity2 xml 
© values 
El AndroidManifest.xml 
[8] proguard.cfg 
(b) SubActivity2 B project.properties 


6.4  ActivityCommunication 的 两 个 子 Activity 图 6.5  ActivityCommunication 文件 结构 
ActivityCommunicationActivity. java 文件 的 核心 代码 如 下 。 


1 public class ActivityCamunicationActivity extends Activity { 
2 private static final int SUBACTIVITYl- 1; 


3 private static final int SUBACTIVITY2- 2; 

4 TextView textView; 

5 @ Override 

6 public void onCreate (Bundle savedInstanceState) ( 

3 super.onCreate (savedInstanoeState) ; 

8 setContentView (R. layout main) ; 

9 textView- (TextView) findViewById (R.id.textShow) ; 

10 final Button btnl- (Button) findViewByld (R.id.btnl) ; 

1l final Button btn2- (Button) findViewById (R.id.btn?) ; 

12 

13 btnl.setonClickListener (new OnClickListener () ( 

14 public void onClick (View view) ( 

15 Intent intent- new Intent (ActivityOamunication.this, 
SiPctivityl.class); 

16 StartActivityForResult (intent, SUBACTIVITY1); 

17 H 

18 H; 

19 

20 btn2.setonClickListener (new OnClickListener () ( 

pi public void onClick (View view) { 

2 Intent intent- new Intent (ActivityCamunication.this, 


Suübhctivity2.class); 
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23 StartActivityForResult (intent, SUBACTIVITY2) 7 

24 k 

25 Ð; 

26 } 

2r 

28 G Override 

29 protected void onActivityResult (int requestCode, int resultCode, 
Intent data) ( 

30 super.onActivityResult (requestCode, resultCode, data); 

3l 

z switch (requestCode) ( 

33 case SUBACTIVITY!: 

3 if (resultCode- - RESULT OK) ( 

35 Uri uriData- data.getTData () ; 

36 textView.setText (uriData.toString ()) ; 

3] ) 

38 break; 

39 case SUBACTIVITY2: 

40 break; 

4l } 

2 ) 

43 ] 


在 代码 的 第 2 行 和 第 3 行 分 别 定义 了 两 个 子 Activity 的 请 求 码 。 在 代码 的 第 16 行 
和 第 23 行 以 Sub-Activity 的 方式 分 别 启动 两 个 子 Activity。 代 码 第 29 行 是 子 Activity 
关闭 后 的 返回 值 处 理 函 数 ,其 中 requestCode 是 子 Activity 返回 的 请 求 码 ,与 第 2 行 和 第 
3 行 定义 的 两 个 请 求 码 相 匹配 ;resultCode 是 结果 码 , 在 代码 第 32 行 对 结果 码 进行 判断 ， 
如 果 等 于 RESULT_OK ,在 第 35 行 代码 获取 子 Activity 返回 值 中 的 数据 ;data 是 返回 
值 , 子 Activity 需要 返回 的 数据 就 保存 在 data 中 。 

SubActivityl. java 的 核心 代码 如 下 。 


public class SubActivityl extends Activity { 

@ Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView(R. layout .subactivityl) ; 
final EditText editText- (EditText) findViewById(R.id.edit) ; 
Button btnCK- (Button) findViewById(R.id.btn ok); 
Button btnCancel- (Button) findViewById(R.id.btn cancel); 
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10 btnOK.setonclickListener (new OnClickListener () ( 
1l public void onClick (View view) { 
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12 String uriString= editText.getText () .toString() ; 
13 Uri data- Uri .parse (uriString); 

14 Intent result- new Intent (null, data); 

15 setResult (RESULT CK, result); 

16 finish; 

0 ) 

18 H; 

19 

20 btnCancel .setOnClickListener (new OnClickListener () ( 
21 Public void onClick (View view) { 

2 setResult(RESULT CANCEIED, null); 

23 finish(; 

24 ) 

25 n; 

26 } 

zg } 


代码 第 13 行将 EditText 控件 的 内 容 作 为 数据 保存 在 Uri 中 ,并 在 第 14 行 代码 
中 构造 Intent。 在 第 15 行 代码 中 ,RESUIT_OK 作为 结果 码 , 通 过 调用 setResult() 
函数 ,将 result 设 定 为 返回 值 。 最 后 在 代码 第 16 行 调 用 finish() 函 数 关闭 当前 的 子 


Activity; 
SubActivity2. java 的 核心 代码 。 


1  püblic class SubActivity? extends Activity { 
2 @ Override 

3 public void onCreate (Bundle savedInstanceState) { 

4 super.onCreate (savedInstanceState) ; 

5 setContentView (R. layout . subactivity2) ; 

6 

了 Button btnReturmn- (Button) findViewById (R.id.btn retum); 
8 btnReturn.setonClickListener (new OnClickListener(){ 

9 public void onClick (View view) { 

10 SetResult (RESULT CANCEIED, null); 

nu finish; 

12 ) 

13 pn: 

14 ] 

15 ] 


在 SubActivity2 的 代码 中 ,第 10 行 的 setResult() 函 数 仅 设置 了 结果 码 , 第 2 个 参数 


为 null, 表 示 没 有 数据 需要 传递 给 父 Activity。 
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隐 式 启动 Activity 时 ,并 没有 在 Intent 中 指明 Activity 所 在 的 类 ,因此 ,Android 系 
统一 定 存在 某 种 匹配 机 制 ,使 Android 系统 能 够 根据 Intent 中 的 数据 信息 ,找到 需要 启 
动 的 Activity。 这 种 匹配 机 制 是 依靠 Android 系统 中 的 Intent 过 滤器 (Intent Filter) 来 
实现 的 。 

Intent 过 滤器 是 一 种 根据 Intent 中 的 动作 (action)、 类 别 (category) 和 数据 (data) 等 
内 容 , 对 适合 接收 该 Intent 的 组 件 进行 匹配 和 筛选 的 机 制 。Intent 过 滤器 可 以 匹配 数据 
类 型 .路 径 和 协议 ,还 可 以 确定 多 个 匹配 项 顺序 的 优先 级 (priority)。 应 用 程序 的 
Activity, Service 和 BroadcastReceiver 组 件 都 可 以 注册 Intent 过 滤器 。 这 样 ,这 些 组 件 
在 特定 的 数据 格式 上 则 可 以 产生 相应 的 动作 。 

为 了 使 组 件 能 够 注册 Intent 过 滤器 ,通常 在 AndroidManifest. xml 文件 的 各 个 组 件 
下 定义 二 intentrfilter 之 节点 ,然后 在 二 intent-filter 过 节点 中 声明 该 组 件 所 支持 的 动作 、 
执行 的 环境 和 数据 格式 等 信息 。 当 然 ,也 可 以 在 程序 代码 中 动态 地 为 组 件 设置 Intent 过 
滤器 。< 一 intentrfilter 过 节点 支持 二 action 二 标签 ,一 category 二 标签 和 二 data 二 标签 ,分 
别 用 来 定义 Intent 过 滤器 的 动作 、 类 别 和 数据 。 二 intent-filter 二 节点 支持 的 标签 和 属性 
说 明 参 考 表 6. 2。 


36.2 一 intentfilter 二 节点 属性 
标 签 属 性 说 有明 
指定 组 件 所 能 响应 的 动作 ,用 字符 串 表示 ,通常 由 Java 类 名 和 
包 的 完全 限定 名 构成 


<action> android ; name 


<category> | android:category 指定 以 何 种 方式 去 服务 Intent 请 求 的 动作 


Android:host 指定 一 个 有 效 的 主机 名 
android:mimetype | 指定 组 件 能 处 理 的 数据 类 型 

— data android: path 有 效 的 URI 路 径 名 
android: port 主机 的 有 效 端口 号 


android:scheme 所 需要 的 特定 协议 


—category > bi 4& FH2E JEE Intent 过 滤器 的 服务 方式 ,每 个 Intent 过 滤器 可 以 定义 
多 个 二 category 二 标签 .程序 开发 人 员 可 以 使 用 自 定 义 的 类 别 ,或 使 用 Android 系统 提供 
的 类 别 。Android 系统 提供 的 类 别 可 以 参考 表 6. 3。 

AndroidManifest. xml 文件 中 每 个 组 件 的 一 intentfilter 二 都 被 解析 成 一 个 Intent 过 
滤器 对 象 。 当 应 用 程序 安装 到 Android 系统 时 ,所 有 的 组 件 和 Intent 过 滤器 都 会 注册 到 
Android 系统 中 。 这 样 ,Android 系统 便 可 以 将 任何 一 个 Intent 请 求 通过 Intent 过 滤器 
映射 到 相应 的 组 件 上 。 
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表 6.3 Android 系统 提供 的 类 别 
值 说 明 
ALTERNATIVE Intent 数据 默认 动作 的 一 个 可 替换 的 执行 方法 
SELECTED_ALTERNATIVE RUNE 类 似 , 但 替换 的 执行 方法 不 是 指定 的 ,而 是 被 解 
BROWSABLE 声明 Activity 可 以 由 浏览 器 启动 
DEFAULT 为 Intent 过 滤器 中 定义 的 数据 提供 默认 动作 
HOME 设备 启动 后 显示 的 第 一 个 Activity 
LAUNCHER 在 应 用 程序 启动 时 首先 被 显示 


这 种 Intent 到 Intent 过 滤器 的 映射 过 程 称 为 "Intent 解析 ”。Intent 解析 可 以 在 所 有 
的 组 件 中 ,找到 一 个 可 以 与 请 求 的 Intent 达成 最 佳 匹配 的 Intent 过 滤器 。Android 系统 
中 Intent 解析 的 匹配 规则 为 ， 

(1) Android 系统 把 所 有 应 用 程序 包 中 的 Intent 过 滤器 集合 在 一 起 ,形成 一 个 完整 
的 Intent 过 滤器 列表 。 

(2) 在 Intent 与 Intent 过 滤器 进行 匹配 时 ,Android 系统 会 将 列表 中 所 有 Intent 过 
滤器 的 “动作 >” 和" 类别? 与 Intent 进行 匹配 ,任何 不 匹配 的 Intent 过 滤器 都 将 被 过 滤 掉 。 
没有 指定 “动作 ”的 Intent 过 滤器 可 以 匹配 任何 的 Intent, 但 是 没有 指定 “类 别 ” 的 Intent 
过 滤器 只 能 匹配 没有 “类 别 * 的 Intent; 

(3) 把 Intent 数据 Uri 的 每 个 子 部 与 Intent 过 滤器 的 二 data 二 标签 中 的 属性 进行 匹 
配 , 如 果 二 data 二 标签 指定 了 协议 、 主 机 名 、 路 径 名 或 MIME 类 型 ,那么 这 些 属性 都 要 与 
Intent 的 Uri 数据 部 分 进行 匹配 ,任何 不 匹配 的 Intent 过 滤器 均 被 过 滤 掉 。 

(4) 如 果 Intent 过 滤器 的 匹配 结果 多 于 一 个 , 则 可 以 根据 在 二 intent-filter 二 标签 中 
定义 的 优先 级 标签 来 对 Intent 过 滤器 进行 排序 ,优先 级 最 高 的 Intent 过 滤器 将 被 选择 。 

IntentResolutionDemo 示例 说 明了 如 何在 AndroidManifest. xml 文件 中 注册 Intent 
过 滤器 ,以 及 如 何 设置 二 intent-filter 二 节点 属性 来 捕获 指定 的 Intent。 

AndroidManifest. xml 的 完整 代码 如 下 。 


1 <?xml version- "1.0" encoding- "utf- 8"?> 
2 «manifest xmlns:android- "http: //schemas .android.com/apk/res/android" 
3 package- "edu.hrbeu.IntentResolutionDemo" 
4 android:versionCode- "1" 
5 android:versionName- "1.0"» 
6 « application android:icon- "8 drawable/icon" android:label- 
"Q string/app name" 


了 «activity android:name= ".IntentResolutionDemo" 
android:label- "@ string/app name" 

9 < intent- filter» 

10 <action android:name- "android.intent.action.MAIN"/» 

n < category android:name- "android. intent.category. 


LAUNCHER"/» 
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12 « /intent- filter» 

13 < /activity> 

14 < activity android:name- ".ActivityToStart" 

15 android:label- "@ string/app name" 

16 < intent- filter» 

17 <action android:name- "android. intent .action.VIEW" /» 

18 « category android:name- "android.intent.category 
.IEFAULT"/»- 

19 < data android:scheme- "schemodero" android:host- "edu.hrbeu"/» 

20 < /intent- filter» 

21 < /activity> 

2 < /application» 

23 < uses- sdk android:minSdkVersion- "14"/> 

24  «/manifest^ 


在 代码 的 第 7 行 和 第 14 行 分 别 定义 了 两 个 Activity。 第 9 £7 8058 12 行 是 第 1 个 
Activity 的 Intent 过 滤器 ,动作 是 android. intent. action. MAIN, 类 别 是 android. intent 
. category. LAUNCHER., ,由 此 可 知 , 这 个 Activity 是 应 用 程序 启动 后 显示 的 默认 用 户 界面 。 

第 16 行 到 第 20 行 是 第 2 个 Activity 的 Intent 过 滤器 ,过 滤器 的 动作 是 android. intent 
. action, VIEW, 表 示 根 据 Uri 协议 ,以 浏览 的 方式 启动 相应 的 Activity; 类 别 是 android. intent 
. category. DEFAULT, 表示 数据 的 默认 动作 ;数据 的 协议 部 分 是 android: scheme — 
"schemodemo" ,数据 的 主机 名 称 部 分 是 android : host — "edu. hrbeu" 

在 IntentResolutionDemo. java 文件 中 ,定义 了 一 个 Intent 用 来 启动 另 一 个 Activity, 这 
个 Intent 与 Activity 设置 的 Intent 过 滤器 是 完全 匹配 的 。IntentResolutionDemo. java 文件 
中 Intent 实例 化 和 启动 Activity 的 代码 如 下 。 


1 Intent intent- new Intent (Intent.ACTION VIEW, Uri.parse ("scherodgmo: / /eda.hrbeu/path") ) ; 
2 startActivity (intent) ; 


代码 第 1 行 所 定义 的 Intent ,动作 为 Intent. ACTION. VIEW, $ Intent 过 滤器 的 动 
作 android. intent. action. VIEW 匹配 ; Uri 是 schemodemo: / /edu. hrbeu/path ,其 中 的 协 
议 部 分 为 schemodemo ,主机 名 部 分 为 edu. hrbeu, 也 与 Intent 过 滤器 定义 的 数据 要 求 完 
全 匹配 。 因 此 ,代码 第 1 行 定义 的 Intent, Æ Android 系统 与 Intent 过 滤器 列表 进行 匹配 
时 ,会 与 AndroidManifest. xml 文件 中 ActivityToStart 定义 的 Intent 过 滤器 完全 匹配 。 
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Intent 的 另 一 种 用 途 是 发 送 广播 消息 ,应 用 程序 和 Android 系统 都 可 以 使 用 Intent 
发 送 广播 消息 ,广播 消息 的 内 容 是 可 以 与 应 用 程序 密切 相关 的 数据 信息 ,也 可 以 是 
Android 的 系统 信息 ,例如 网 络 连接 变化 .电池 电量 变化 .接收 的 短信 或 系统 设置 变化 等 。 
如 果 应 用 程序 注册 了 BroadcastReceiver, 则 可 以 接收 到 指定 的 广播 消息 。 
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使 用 Intent 发 送 广播 消息 非常 简单 ,只 须 创 建 一 个 Intent, 并 调用 sendBroadcast O 
函数 就 可 把 Intent 携带 的 信息 广播 出 去 。 但 需要 注意 的 是 ,在 构造 Intent 时 必须 定义 一 
个 全 局 唯一 的 字符 串 ,用 来 标识 其 要 执行 的 动作 ,通常 使 用 应 用 程序 包 的 名 称 。 如 果 要 
在 Intent 传递 额外 数据 ,可 以 用 Intent 的 putExtra() 方 法 。 下 面 的 代码 构造 了 用 于 广播 
消息 的 Intent, 并 添加 了 额外 的 数据 ,然后 调用 sendBroadcast() 发 送 广播 消息 : 


String UNIQUE. STRING- "edu.hrbeu.BroadcastFeceiverDemo"; 
Intent intent- new Intent (UNIQUE STRING); 
intent.putExtra ("keyl", "valuel"); 

intent.putExtra ("key2", "value2"); 

sendBroadcast (intent) ; 
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BroadcastReceiver 用 于 监听 广播 消息 ,可 以 在 AndroidManifest. xml 文件 或 代码 中 注册 


-个 BroadcastReceiver. 并 使 用 Intent 过 滤器 指定 要 处 理 的 广播 消息 创建 
BroadcastReceiver 须要 继承 BroadcastReceiver 类 ,并 重 载 onReceive() 方 法 。 示 例 代 码 如 下 。 
1 public class MyBroadcastReceiver extends BroadcastReceiver { 
2 @ Override 
3 public void onReceive (Context context, Intent intent) ( 
4 //TODO: Feact to the Intent. received. 
5 } 
6 } 
当 Android 系统 接收 到 与 注册 BroadcastReceiver 匹配 的 广播 消息 时 ,Android 系 
统 会 自动 调用 这 个 BroadcastReceiver 接收 广播 消息 。 在 BroadcastReceiver 接收 到 与 
之 匹配 的 广播 消息 后 ,onReceive( ) 方 法 会 被 调用 ,但 onReceive( ) 方 法 必须 要 在 5 Eb 


钟 执行 完毕 ,否则 Android 系统 会 认为 该 组 件 失去 响 | 
应 ,并 提示 用 户 强 行 关闭 该 组 件 。 BroadcastReceiverDemo 


BroadcastReceiverDemo 示例 说 明了 如 何在 应 用 程 
序 中 注册 BroadcastReceiver 组 件 , 并 指定 接收 广播 消 
息 的 类 型 。BroadcastReceiverDemo 示例 的 界面 如 
图 6.6 所 示 , 在 点 击 “ 发 送 广 播 消 息 ” 按 钮 后 ， 
EditText 控件 中 的 内 容 将 以 广播 消息 的 形式 发 送出 
去 ,示例 内 部 的 BroadcastReceiver 将 接收 这 个 广播 消 
息 , 并 显示 在 用 户 界面 的 下 方 。 

BroadcastReceiverDemo. java 文件 中 包含 发 送 广 播 
消息 的 代码 ,其 关键 代码 如 下 。 — 


图 6.6  BroadcastReceiverDemo 


主 界面 
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button.setonClickListener (new OnClickListener () ( 
public void onClick (View view) { 
Intent intent- new Intent ("edu.hrbeu.BroadcastReceiverDemo") ; 
intent.putExtra ("message", entryText .getText () .toString ()) ; 
sendBroadcast (intent); 


p; 


代码 第 3 行 创 建 Intent 时 ,将 edu. hrbeu. BroadcastReceiverDemo 作为 识别 广播 消息 的 
字符 串 标识 ,并 在 代码 第 4 行 添加 额外 信息 ,最 后 在 代码 第 5 行 调用 sendBroadcast() 函 数 发 
送 广播 消息 。 

为 了 能 够 使 应 用 程序 中 的 BroadcastReceiver 接收 指定 的 广播 消息 ,首先 要 在 
AndroidManifest. xml 文件 中 的 BroadcastReceiver 节点 下 添加 Intent 过 滤器 ,声明 
BroadcastReceiver 可 以 接收 的 广播 消息 类 型 。AndroidManifest. xml 文件 的 完整 代码 


如 下 。 


LEN mb 


<?xml version- "1.0" encoding- "utf- 8"?» 
«manifest xmlns:android- "http: //schemas .android.can/apk/res/android" 
package- "edu.hrbeu.BroadcastReceiverDamo" 
android:versionCode- "1" 
android:versionName- "1.0"» 
< application android:icon- "8 drawable/icon" android:label- 
"Q string/app name"> 
< activity android:name- ".BroadcastReceiverDemo" 
android:label- "8 string/app name" 
< intent- filter» 
<action android:name- "android. intent .action.MAIN"/> 
< category android:name- "android. intent .category. 
IAUNCHER"/> 
< /intent- filter> 
< /activity> 
< receiver android:name- ".MyBroadcastReceiver"» 
< intent- filter» 
< acticn android:name- "edi. hrbeu.BroadcastReceiverDam"/^ 
< /intent- filter» 
< /receiver» 
< /application» 
< uses- sdk android:minSdkVersion- "14"/> 
< /manifest> 


在 代码 的 第 14 行 中 创建 了 一 个 二 receiver 二 节点 ,在 第 15 行 中 声明 了 Intent 过 滤器 
的 动作 为 edu. hrbeu. BroadcastReceiverDemo.3X 5j BroadcastReceiverDemo. java 文件 中 
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Intent 的 动作 相 一 致 ,表明 这 个 BroadcastReceiver 可 以 接收 动作 为 edu. hrbeu 
. BroadcastReceiverDemo 的 广播 消息 。 

MyBroadcastReceiver. java 文件 创建 了 一 个 自 定义 的 BroadcastReceiver, 其 核心 代 
TS. 


public class MyBroadcastReceiver extends BroadcastReoeiver { 
@ override 
public void onReceive (Context context, Intent intent) { 
String msg- intent.getStringextra ("message") ; 
Toast .makeText (context, msg, Toast.IENGTH SHORT) .show(); 


- 0 050 lnu- 


) 


代码 第 1 行 首先 继承 了 BroadcastReceiver 类 ,并 在 第 3 行 重 载 了 onReveiveO MX 
当 接 收 到 AndroidManifest. xml 文件 定义 的 广播 消息 后 ,程序 将 自动 调用 onReveiveO 
函数 进行 消息 处 理 。 代 码 第 4 行 通过 调用 getStringExtra() 函 数 , 从 Intent 中 获取 标识 
JJ message 的 字符 串 数据 ,并 使 用 Toast() 函 数 将 信息 显示 在 界面 上 。 
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. 简 述 Intent 的 定义 和 用 途 。 

. 简 述 Intent 过 滤器 的 定义 和 功能 。 

. 简 述 Intent 解析 的 匹配 规则 。 

.编程 实现 具有 “登录 ”按钮 的 主 界面 ,点 击 “ 登 录 ” 按 钮 后 打开 一 个 新 的 Activity, 
新 打开 的 Activity 上 面 有 输入 用 户 名 和 密码 的 控件 ,在 用 户 关闭 这 个 Activity 后 ,将 用 户 
名 和 密码 传递 到 主 界面 的 Activity 中 。 
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Service 是 Android 系统 的 服务 组 件 , 适 用 于 开发 没有 用 户 界面 且 长 时 间 在 后 台 运 行 
的 功能 。 通 过 本 章 的 学 习 可 以 让 读者 了 解 后 台 服务 的 基本 原理 ,掌握 本 地 服务 与 远程 服 
务 的 使 用 方法 ,有 助 于 深入 理解 Android 系统 的 进程 间 通 信 机 制 。 

本 章 学 习 目 标 : 

* 了 解 Service 的 原理 和 用 途 ; 

。 掌握 本 地 服务 的 管理 方法 ; 

。 掌握 服务 的 隐 式 启动 和 显 式 启动 方法 ; 

。 了 解 线 程 的 启动 、 挂 起 和 停止 方法 ; 

。 了 解 跨 线程 的 界面 更 新 方法 ; 

。 掌握 远程 服务 的 绑 定 和 调用 方法 ; 

。 了 解 AIDL 语言 的 用 途 和 语法 。 


71 Sevice 简介 


因为 手机 硬件 性 能 和 屏幕 尺寸 的 限制 ,通常 Android 系统 仅 允许 一 个 应 用 程序 处 于 
激活 状态 并 显示 在 手机 屏幕 上 ,而 暂停 其 他 处 于 未 激活 状态 的 程序 。 因 此 ,Android 系统 
需要 一 种 后 台 服 务 机 制 , 允 许 在 没有 用 户 界面 的 情况 下 ,使 程序 能 够 长 时 间 在 后 台 运 行 ， 
实现 应 用 程序 的 后 台 服务 功能 ,并 能 够 处 理事 件 或 数据 更 新 。 

Android 系统 提供 的 Service( 服 务 ) 组 件 , 不 直接 与 用 户 交 互 ,能够 长 期 在 后 台 运 行 。 
在 实际 应 用 中 ,有 很 多 应 用 需要 使 用 Service, 经 常 提 到 的 例子 就 是 MP3 播放 器 要 求 在 关 
闭 播放 器 界面 后 ,仍然 能 够 保持 音乐 持续 播放 ,这 就 需要 在 Service 组 件 中 实现 音乐 回放 
功能 。 

Service 适用 于 无 须 用 户 干预 , 且 有 规则 地 运行 或 长 期 运行 的 后 台 功 能 。 首 先 ,因为 
Service 没有 用 户 界面 ,更 加 有 利于 降低 系统 资源 的 消耗 ,而 且 Service HE Activity 具有 更 
高 的 优先 级 ,因此 在 系统 资源 紧张 时 , Service 不 会 被 Android 系统 优先 终止 。 即 使 
Service 被 系统 终止 ,在 系统 资源 恢复 后 Service 也 将 自动 恢复 运行 状态 ,因此 可 以 认为 
Service 是 在 系统 中 永久 运行 的 组 件 。Service 除了 可 以 实现 后 人 台 服 务 功能 ,还 可 以 用 于 
进程 间 通 信 (Inter Process Communication. IPC) ,解决 不 同 Android 应 用 程序 进程 之 间 
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的 调用 和 通信 问题 。 
Service 的 生命 周期 比较 简单 , 仅 包 括 完 整 生命 周期 和 活动 生命 周期 ,还 有 三 个 事件 
回调 函数 ,分 别 是 onCreate() .onStart() 和 onDestroy() ,如 图 7. 1 所 示 。 


调用 - 
i Service Service 关闭 
startService() onCreate() |- onStart() yum E 
启动 Service 被 停止 Service 


图 7.1 Service 生命 周期 


完整 生命 周期 从 onCreate() 开 始 到 onDestroy() 结 束 , 在 onCreate() 中 完成 Service 
的 初始 化 工作 ,在 onDestroy() 中 释放 所 有 占用 的 资源 。 活 动 生命 周期 从 onStart() 开 
始 , 但 没有 与 之 对 应 的 “停止 ?函数 ,因此 可 以 粗略 地 认为 活动 生命 周期 是 以 onDestroy() 
标志 结束 。 

Service 的 使 用 方式 一 般 有 两 种 ,一 种 是 启动 方式 , 另 一 种 是 绑 定 方式 。 在 启动 方式 
中 ,通过 调用 Context. startService O 启动 Service, 通 过 调用 Context. stopService() 或 
Service. stopSelf() 停 止 Service。 因 此 ,Service 一 定 是 由 其 他 的 组 件 启动 的 ,但 停止 过 程 
可 以 通过 其 他 组 件 或 自身 完成 。 

在 启动 方式 中 ,启动 Service 的 组 件 不 能 够 获取 Service 的 对 象 实例 ,因此 无 法 调用 
Service 中 的 任何 函数 ,也 不 能 够 获取 Service 中 的 任何 状态 和 数据 信息 。 能 够 以 启动 方 
式 使 用 的 Service, 需 要 具备 自 管理 的 能 力 , 而 且 不 需要 通过 函数 调用 获取 Service 的 功能 
和 数据 。 

在 绑 定 方式 中 ,Service 的 使 用 是 通过 服务 连接 (connection) 实 现 的 ,服务 连接 能 够 获 
取 Service 的 对 象 实例 ,因此 绑 定 Service 的 组 件 可 以 调用 Service 中 实现 的 函数 ,或 直接 
获取 Service 中 的 状态 和 数据 信息 。 使 用 Service 的 组 件 通过 Context. bindService O Œ 
立 服务 连接 ,通过 Context. unbindService() 停 止 服务 连接 。 如 果 在 绑 定 过 程 中 Service 
没有 启动 ,Context. bindService() 会 自动 启动 Service. 而且 同一 个 Service 可 以 绑 定 多 个 
服务 连接 ,这 样 可 以 同时 为 多 个 不 同 的 组 件 提 供 服务 。 

当然 ,这 两 种 使 用 方法 并 不 是 完全 独立 的 , 某 些 情况 下 可 以 混合 使 用 启动 方式 和 绑 
定 方 式 。 还 是 以 MP3 播放 器 为 例 , 在 后 台 工 作 的 Service 通过 Context. startService() 启 
动 某 个 音乐 播放 ,但 在 播放 过 程 中 如 果 用 户 需要 暂停 音乐 播放 , 则 需要 通过 Context 
. bindService() 获 取 服 务 连接 和 Service 对 象 实例 ,进而 通过 调用 Service 对 象 实例 中 的 函 
数 ,和 暂停 音乐 播放 过 程 ,并 保存 相关 信息 。 在 这 种 情况 下 ,如 果 调 用 Context. stopServiceOJf- 
不 能 够 停止 Service ,需要 在 所 有 的 服务 连接 关闭 后 ,Service 才能 够 真正 停止 。 
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本 地 服务 的 调用 者 和 服务 都 在 同一 个 程序 中 ,是 不 需要 跨 进程 就 可 以 实现 服务 的 调 
用 。 本 地 服务 涉及 服务 的 建立 .启动 和 停止 ,服务 的 绑 定 和 取消 绑 定 ,以 及 如 何在 线程 中 
实现 服务 。 
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721 服务 管理 


服务 管理 主要 指 服务 的 启动 和 停止 ,在 介绍 如 何 启动 和 停止 服务 前 ,首先 说 明 如 何在 
代码 中 实现 Service, Service 是 一 段 在 后 台 运 行 、 没 有 用 户 界面 的 代码 ,其 最 小 代码 集 如 下 。 


import android.app.Service; 
import android.content.Intent; 
import android.os.IBinder; 


public class RandamService extends Service( 
@ Override 
public IBinder onBird (Intent intent) { 
return null; 
) 


(€ Oo - o c UI -d| 


10 } 


在 上 面 的 代码 中 ,第 1 行 到 第 3 行 引 入 必要 包 外 ,第 5 行 声明 了 RandomService 继承 
了 android. app. Service 类 ,第 7 行 到 第 9 行 重 载 了 onBind O PRX, onBind O PR ZZ E 
Service 被 绑 定 后 调用 的 函数 ,能 够 返回 Service 的 对 象 实例 ,在 后 面 的 内 容 中 会 有 详细 的 
介绍 。 

这 个 Service 最 小 代码 集 并 没有 任何 实际 的 功能 ,为 了 使 Service 具有 实际 意义 ,一 
般 需 要 重 载 onCreate() .onStart() 和 onDestroy()。Android 系统 在 创建 Service 时 ,会 
自动 调用 onCreateO ,用 户 一 般 在 onCreate O 函数 中 完成 必要 的 初始 化 工作 ,例如 创建 
线程 ,建立 数据 库 连接 等 。 在 Service 关闭 前 ,系统 会 自动 调用 onDestroy O 函数 释放 所 
有 占用 的 资源 。 通 过 Context. startService(Intent) 启 动 Service,onStart() 则 会 被 调用 ， 
重要 的 参数 通过 参数 Intent 传递 给 Service。 当 然 , 不 是 所 有 的 Service 都 需要 重 载 这 三 
个 函数 ,可 以 根据 实际 情况 选择 需要 重 载 的 函数 。 


3 public class RandamService extends Service( 
2 @ Override 

3 püblic void onCreate() { 

4 super .oncCreate () ; 

5 P 

6 & Override 

7 public void onStart (Intent intent, int startId) ( 
8 Super.onStart (intent, startId); 
9 ) 

10 @ Override 

1 public void onDestroy() { 

12 Super.onDestroy () ; 

13 ) 
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重 载 onCreate()、onStart() 和 onDestroy() 三 个 函数 时 ,务必 要 在 代码 中 调用 父 函 
数 , 如 代码 的 第 4 行 , 第 8 行 和 第 12 行 。 

完成 Service 类 后 ,需要 在 AndroidManifest. xml 文件 中 注册 这 个 Service。 注 册 
Service 非常 重要 ,如 果 开 发 人 员 不 对 Service 进行 注册 , 则 Service 根本 无 法 启动 。 
AndroidManifest. xml 文件 中 注册 Service 的 代码 为 : 


< service android:name- " .RandanService"/» 


使 用 一 service 二 标签 声明 服务 ,其 中 的 android: name 表示 Service 类 的 名 称 , 一 定 要 
与 建立 的 Service 类 名 称 一 致 。 

在 完成 Service 代码 和 在 AndroidManifest. xml 文件 中 注册 后 ,下 面 来 说 明 如 何 启 动 和 
停止 Service。 有 两 种 方法 启动 Service: 显 式 启动 和 隐 式 启动 。 显 式 启动 需要 在 Intent 中 指 
HH Service 所 在 的 类 ,并 调用 startService(Intent) 启 动 Service, 示 例 代码 如 下 。 


1 final Intent serviceIntent- new Intent (this, RandamService.class); 
2 StartService (serviceIntent) ; 


在 上 面 的 代码 中 ,Intent 指明 了 启动 的 Service 所 在 类 为 RandomSerevice, 
隐 式 启动 则 需要 在 注册 Service 时 ,声明 Intent-filter 的 action 属性 。 


1 < service android:name- ".RandomServioe"> 

2 < intent- filter» 

3 «action android:name- "edu.hrbeu.RandamServioe"/» 
4 < /intent- filter» 

5 


< /service» 


在 隐 式 启动 Service 时 ,需要 设置 Intent 的 action 属性 ,这样 则 可 以 在 不 声明 Service 
所 在 类 的 情况 下 启动 服务 。 隐 式 启动 的 代码 如 下 。 


1 final Intent serviœIntent= new Intent ()7 
2 serviceIntent..setAction ("edu.hrbeu.RandamService") ; 


如 果 服 务 和 调用 服务 的 组 件 在 同一 个 应 用 程序 中 ,可 以 使 用 显 式 启动 或 隐 式 启动 ， 
显 式 启动 更 加 易于 使 用 , 且 代 码 简洁 。 但 如 果 服 务 和 调用 服务 的 组 件 在 不 同 的 应 用 程序 
中 , 则 只 能 使 用 隐 式 启动 。 

无 论 是 显 式 启动 还 是 隐 式 启动 ,停止 Service 的 方法 都 是 相同 的 ,将 启动 Service 的 
Intent 传递 给 stopService(Intent) 函数 即 可 ,示例 代码 如 下 。 


stopService (serviceIntent) ; 


在 首次 调用 startServiceCIntent) 函数 启动 Service 后 ,系统 会 先后 调用 onCreateO RI 
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onStart()。 如 果 是 第 二 次 调用 startService(Intent) 函 数 , 系 统 则 仅 调用 onStart() ,而 不 再 
调用 onCreate()。 在 调用 stopService(Intent) 函数 停止 


5 


Service 时 ,系统 会 调用 onDestroy()。 无 论调 用 过 多 少 [B simpleRandomServiceDemo 
次 startService(Intent) ,在 调用 stopService( Intent) 函数 uad ino anii 


| 动 
时 ,系统 仅 调 用 一 次 onDestroy() 。 Hone 


SimpleRandomServiceDemo 是 在 应 用 程序 中 使 
用 Service 的 示例 ,这 个 示例 使 用 显 式 启动 的 方式 启动 
Service。 在 工程 中 创建 了 RandomService 服务 ,该 服 
务 启动 后 会 产生 一 个 随机 数 ,并 使 用 Toast 显示 在 屏 
幕 上 ,如 图 7.2 所 示 。 

通过 界面 上 的 “启动 Service” 按 钮 调用 
startService(Intent) 函数 ,启动 RandomService 服务 。 
通过 “停止 Service” 按 钮 调用 stopService (Intent) PR 
数 , 停 止 RandomService 服务 。 为 了 能 够 清晰 地 观察 


2 


停止 Service 


7.2 SimpleRandomServiceDemo 
用 户 界面 


Service 中 onCreate() .onStart() 和 onDestroy() 
函数 的 调用 顺序 ,在 每 个 函数 中 都 使 用 Toast 在 界面 上 产生 提示 信息 。 
RandomService. java 文件 的 代码 如 下 。 


1 package edu.hrbeu.SimpleRandmServiceDemo; 


" 
3 import android.app.Servioce; 

4 import android.content.Intent; 
5 import android.os.IBinder; 

6 import android.widget.Toast; 
7 
8 
9 


public class RandamService extends Service( 


10 @ Override 

nu pdblic void onCreate() ( 

12 Super .onCreate () ; 

13 Toast.makeText (this, "(1) 调用 oncreate ( ", 
14 Toast.IENGIH IONG) .show()7 

15 ) 

16 

17 @ Override 

18 public void onStart (Intent intent, int startId) ( 
19 super.onStart (intent, startId); 

20 Toast .makeText (this, "(2) 调用 onstartQ", 
2 Toast.IENGIH SHORT) .show () ; 
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23 double randamDouble- Math.random(); 

24 Stringmsg- "随机 数 : "+ String.valueOf (randamDouble) ; 
25 Toast.makeText (this,msg, Toast.IENGTH SHORT) .show(); 
26 ) 

27 

28 @ Override 

29 public void onDestroy() ( 

30 Super .onDestroy () ; 

a Toast.makeText (this, "(3) 调用 onDestroy ) ", 

3 Toast.IENGIH SHORT) .show () ; 

33 ) 

34 

35 G Override 

36 public IBinder onBind(Intent intent) ( 

3] return null; 

38 

39 


在 onStart() 函 数 中 添加 生成 随机 数 的 代码 ,第 23 行 生成 一 个 介 于 0 和 1 之 间 的 随 
机 数 , 并 在 第 24 行 构造 供 Toast 显示 的 消息 。 
AndroidManifest. xml 文件 的 代码 如 下 。 


1 <?xml version- "1.0" encoding- "utf- 8"?> 
2 «manifest xmins:android- "http://schemas.android.con/apk/res/android" 
3 package- "edu.hrbeu. SimpleRandamServioeDero" 
4 android:versionCode- "1" 
5 android:versionName- "1.0"> 
6 < application android:icon- "@ drawable/icon" 
android:label- "8 string/app name" 
1 < activity android:name- ".SimpleRandamServioeDemo" 
8 android:label- "8 string/app name" 
9 < intent- filter» 
10 < action android:name- "android. intent .action.MAIN"/> 
u < category android:name- "android. intent .category 
.IAUNCHER"/> 
12 < /intent- filter> 
B < /activity> 
14 < service android:name- ".RandomService"/> 
15 < /application» 
16 < uses- sdk android:minSdkVersion- "14"/» 
17  «/manifest^ 
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在 AndroidManifest. xml 文件 中 ,在 二 application 过 标签 下 ,包含 一 个 二 activity 过 标签 和 
一 个 二 service 二 标签 ,在 二 service 放 标签 中 ,声明 了 RandomService 所 在 的 类 。 
SimpleRandomServiceDemoActivity. java 文件 的 代码 如 下 。 


1 package edu.hrbeu.SimpleRandamServioeDemo; 

5 

3 import android.app.Activity; 

4 inport android.content.Intent; 

5 import android.os.Bundle; 

6 import android.view.View; 

7  ámport android.widget.Button; 

8 

9  püblic class SimpleRandamServioeDemohctivity extends Activity ( 

10 G Override 

1l public void onCreate (Bundle savedInstanceState) ( 

12 Super .onCreate (savedInstanceState) ; 

13 setContentView (R.layout.main) ; 

14 

35 Button startButton- (Button) findViewById(R.id.start); 

16 Button stopButton- (Button)findViewByld(R.id.stop); 

17 final Intent serviceIntent- new Intent (this, RandamServioe 
class); 

18 startButton.setOnClickListener (new Button.OnClickListener() ( 

19 public void onClick (View view) ( 

20 StartService (serviceIntent) ; 

2 ) 

2 p; 

23 stopButton.setOnClickListener (new Button.OnClickListener () ( 

24 public void onClick (View view) ( 

25 StopService (serviceIntent) ; 

26 } 

2 p; 

28 } 

2 } 


SimpleRandomServiceDemoActivity. java 文件 是 应 用 程序 中 的 Activity 代码 ,第 20 
行 和 第 25 行 分 别 是 启动 和 停止 Service 的 代码 。 

这 里 不 再 给 出 隐 式 启动 Service 的 示例 代码 ,请 参考 ImplicityRandomServiceDemo 
示例 。 


722 使 用 线程 


在 Android 系统 中 ,Activity ,Service 和 BroadcastReceiver 都 是 工作 在 主线 程 上 , 因 
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此 任何 耗 时 的 处 理 过 程 都 会 降低 用 户 界面 的 响应 速度 ,甚至 导致 用 户 界面 失去 响应 。 当 
用 户 界面 失去 响应 超过 5 秒 后 ,Android 系统 会 允许 用 户 Ts 
强行 关闭 应 用 程序 ,提示 如 图 7. 3 所 示 。 因 此 , 较 好 的 解 is not responding. Would you 
决 方法 是 将 耗 时 的 处 理 过程 转 移 到 子 线程 上 ,这 样 可 以 Mails 
缩短 主线 程 的 事件 处 理 时 间 , 从 而 避免 用 户 界面 长 时 间 vis 
失去 响应 。“ 耗 时 的 处 理 过 程 ” 一 般 指 复杂 运算 过 程 \. 大 图 7.3 失去 响应 时 的 提示 信息 
量 的 文件 操作 、 存 在 延 时 的 网 络 通信 和 数据 库 操 作 等 。 

线程 是 独立 的 程序 单元 ,多 个 线程 可 以 并 行 工 作 。 在 多 处 理 器 系统 中 ,每 个 中 央 处 
理 器 (CPU) 单 独 运 行 一 个 线程 ,因此 线程 是 并 行 工 作 的 。 但 在 单 处 理 器 系统 中 ,处 理 器 
会 给 每 个 线程 一 小 段 时 间 ,在 这 个 时 间 内 线程 是 被 执行 的 ,然后 处 理 器 执行 下 一 个 线程 ， 
这 样 就 产生 了 线程 并 行 运行 的 假象 。 无 论 线程 是 否 真 的 并 行 工作 ,在 宏观 上 可 以 认为 子 
线程 是 独立 于 主线 程 的 , 且 能 与 主线 程 并 行 工 作 的 程序 单元 。 

在 Java 语言 中 ,建立 和 使 用 线程 比较 简单 ,首先 需要 实现 Java 的 Runnable 接口 ,并 
ER run() 函 数 ,在 run() 中 放置 代码 的 主体 部 分 。 


Y private Runnable backgroundWork- new Runnable () { 
2 G Override 

3 public void run() ( 

4 // 过 程 代 码 

5 ) 

6 


F 


然后 创建 Thread 对 象 ,并 将 Runnable 对 象 作为 参数 传递 给 Thread 对 象 。 在 
Thread 的 构造 函数 中 ,第 1 个 参数 用 来 表示 线程 组 ,第 2 个 参数 是 需要 执行 的 Runnable 
对 象 , 第 3 个 参数 是 线程 的 名 称 。 


1 private Thread workThread; 
2 workThread- new Thread (null, backgroundWork, "WorkThread") ; 


最 后 ,调用 start() 方 法 启动 线程 。 


workThread.start () ; 


当 线 程 在 run() 方 法 返回 后 ,线程 就 自动 终止 了 。 当 然 ,也 可 以 调用 stop() 在 外 部 终 
止 线 程 , 但 这 种 方法 并 不 推荐 使 用 ,因为 这 方法 并 不 安全 ,有 一 定 可 能 性 会 产生 异常 。 最 
好 的 方法 是 通知 线程 自行 终止 ,一 般 调 用 interrupt() 方 法 通告 线程 准备 终止 ,线程 会 释 
放 它 正在 使 用 的 资源 ,在 完成 所 有 的 清理 工作 后 自行 终止 。 


workThread.interrupt () ; 


HK interrupt() 方 法 并 不 能 直接 终止 线程 , 仅 是 改变 了 线程 内 部 的 一 个 布尔 值 ,run() 
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方法 能 够 检测 到 这 个 布尔 值 的 改变 ,从 而 在 适当 的 时 候 释放 资源 和 终止 线程 。 在 run() 
中 的 代码 一 般 通 过 Thread. interrupted() 方 法 查询 线程 是 否 被 中 断 。 一 般 情况 下 , 子 线 
程 需 要 无 限 运行 ,除非 外 部 调用 interrupt() 方 法 中 断 线 程 ,所 以 通常 会 将 程序 主体 放置 
在 whileO PR 3f 38 FH. Thread. interrupted() 方 法 判断 线程 是 否 应 被 中 断 。 下 面 的 代 
码 中 ,以 1 秒 为 间隔 循环 检测 线程 是 否 应 被 中 断 。 


piblic void rm() ( 
while('Thread.interrupted()) ( 
// 过 程 代码 
Thread.sleep (1000); 


o 0c mw PP 


) 


第 4 行 代 码 使 线程 休眠 1000 毫秒 。 当 线程 在 休眠 过 程 中 被 中 断 , 则 会 产生 
InterruptedException 异常 。 在 中 断 的 线程 上 调用 sleep() 方 法 ,同样 会 产生 Interrupted- 
Exception 异常 。 因 此 代码 中 须要 捕获 InterruptedException 异常 ,保证 安全 终止 线程 。 


public void run() ( 
uyt 
while (true) ( 
// 过 程 代 码 
Thread.sleep (1000) ; 
) 
) catch (InterruptedExoeption e) ( 
e.printStackTrace(); 
) 
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10 } 


到 这 里 读者 已 经 可 以 设计 自己 的 线程 ,但 还 存在 一 个 不 可 回避 的 问题 ,如 何 使 用 线 
程 中 的 数据 更 新 用 户 界面 。Android 系统 提供 了 多 种 方法 解决 这 个 问题 ,这 里 仅 介 绍 使 
用 Handler 更 新 用 户 界面 的 方法 。 

Handler 允许 将 Runnable 对 象 发 送 到 线程 的 消息 队列 中 ,每 个 Handler 实例 绑 定 到 
一 个 单独 的 线程 和 消息 队列 上 。 当 用 户 建立 一 个 新 的 Handler 实例 ,通过 post() 方 法 将 
Runnable 对 象 从 后 台 线 程 发 送 给 GUI 线程 的 消息 队列 , 当 Runnable 对 象 通过 消息 队列 
后 ,这 个 Runnable 对 象 将 被 运行 。 


private static Handler handler- new Handler (); 


1 
2 
3j public static void UpdateGUI (double refreshDouble) { 
4 handler .post (RefreshlLable) ; 

5 


H 
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6 private static Runnable Refreshlable- new Runnable () { 
7 G Override 

8 public void run() { 

9 // 过 程 代码 

10 

u j 


在 上 面 的 代码 中 ,第 1 行 建立 了 一 个 静态 的 Handler 实例 ,但 这 个 实例 是 私有 的 ,因此 
外 部 代码 并 不 能 直接 调用 这 个 Handler 实例 。 第 3 íF UpdateGUI() 是 公有 的 界面 更 新 函 
数 ,后 台 线 程 通过 调用 该 函数 ,将 后 台 产 生 的 数据 refreshDouble 传递 到 UpdateGUIO 函数 
内 部 ,然后 直接 调用 post() 方 法 ,将 第 6 行 创建 的 Runnable 对 象 传递 给 界面 线程 (主线 
程 ) 的 消息 队列 中 。 第 8 行 到 第 10 行 代码 是 Runnable 对 象 中 需要 重 载 的 run O PRÉC. JE 
面 更 新 代码 就 在 这 里 。 

ThreadRandomServiceDemo 是 使 用 线程 持续 产生 随机 数 的 示例 。 点 击 “ 启 动 
Service” 按 钮 后 将 启动 后 台 线 程 ,点 击 “ 停 止 Service" 
按钮 将 关闭 后 台 线 程 。 后 台 线 程 每 1 秒 钟 产生 一 个 0 
到 1 之 间 的 随机 数 , 并 通过 Handler 47^ ^E n B6 PLC — m 
显示 在 用 户 界面 上 。ThreadRandomServiceDemo 的 启动 Service 
用 户 界 面 如 图 7.4 所 示 。 

在 ThreadRandomServiceDemo 示 例 P. Random- 
Service. java 文件 是 定义 Service 的 文件 ,用 来 创建 线 7.4 ThreadRandomServiceDemo 
程 、 产 生 随 机 数 和 调用 界面 更 新 函数 。Thread- 用 户 界面 
RandomServiceDemoActivity. java 文件 是 用 户 界 面 
的 Activity 文件 , 封装 Handler 界面 更 新 的 函数 就 在 这 个 文件 中 。 下面 给 出 
RandomService. java 和 ThreadRandomServiceDemoActivity. java 文件 的 完整 代码 。 
RandomService. java 文件 的 完整 代码 : 


À 8:34 


RandomServiceDemo 


停止 Service 


package edu.hrbeu. ThreadRandmServiceDemo; 


1 
3 inport android.app.Servioe; 
4  ámport android.content. Intent; 
5 import android.os.IBinder; 

6 import android.widget.Toast; 
J 
8 
9 


public class RandamService extends Service( 


10 private Thread workIhread; 
n 

12 @ Override 

13 public void onCreate() { 


14 super .onCreate () ; 


KA 后 全 服务 


157 


ROÓSBB5À5gg9gustsusuBmBP5BgSESX3SUsSsUSBSot5bu 


Bos 
A 0 


4 


usuvBaNs 


Toast.makeText (this, "(1) 调用 onCreate()", 
Toast.IENGIH IONS) .show(); 
workThread- new Thread (nul],backgroudWork, "WorkThread") ; 


G Override 
public void onStart (Intent intent, int startId) ( 
sSuper.onStart (intent, startId); 
Toast.makeText (this, "(2) 调用 onstart ", 
Toast.IENGIH SHORT).show(); 
if (IworkThread.isAlive ()){ 
workThread.start () ; 


@ Override 
public void onDestroy() ( 
super.onDestroy () ; 
Toast.makeText (this, "(3) 调用 onDestroy 0", 
Toast.IENGIH SHORT).show(); 
workIhread. interrupt () 


@ Override 
public IBinder onBind(Intent intent) ( 
return null; 


private Runnable backgroundWork- new Runnable () ( 
@ Override 
public void run() ( 
uyt 
while('Thread.interrupted()) { 
double randamDouble- Math.randam() ; 
ThreadRandanServiceDemoActivity.UpdateGUI 
(randamDouble) ; 
Thread.sleep (1000) ; 
) 
} catch (InterruptedExoeption e) ( 
e.printStackTrace() ; 


F 
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ThreadRandomServiceDemoActivity. java 文件 的 完整 代码 : 
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package edu.hrbeu.ThreadRandamServi ceDemo; 


ámport android.app.Activity; 
import android.content.Intent; 
inport android.os.Bundle; 
ámport android.os.Handler; 
import android.view.View; 
import android.widget.Button; 
import android.widget .TextView; 


public class ThreadRandamServioeDemomctivity extends Activity { 


private static Handler handler- new Handler () ; 
private static TextView labelView- null; 
private static double randamDouble; 


public static void UpdateGUI (double refreshDouble) ( 
randamDouble- refreshDouble; 
handler.post (FefreshLable) ; 


private static Runnable RefreshLable- new Runnable () ( 
@ Override 
public void run() ( 
labelView.setText (String.valueOf (randamDouble) ) ; 


F 


G Override 
public void onCreate (Bundle savedInstanceState) { 
Super.onCreate (savedInstanceState) ; 
setContentView (R.layout .main); 
labelView- (TextView) findViewById (R.id.label); 
Button startButton- (Button) findViewById R.id.start); 
Button stopButton- (Button) findViewById(R.id.stop); 
final Intent. serviceIntent- new Intent (this, Randm&ervice.class) ; 


startButton.setOnClickListener (new Button.OnClickListener () ( 
public void onClick (View view) { 


startService (serviceIntent) ; 


pn: 
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44 StopButton.setOnClickListener (new Button.OnClickListener () ( 
45 public void onClick (View view) { 

46 StopService (serviceIntent) ; 

4 } 
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以 绑 定 方式 使 用 Service, 能 够 获取 Service 实例 ,不仅 能 够 正常 启动 Service, 还 能 够 
调用 Service 中 的 公有 方法 和 属性 。 为 了 使 Service 支持 绑 定 , 需 要 在 Service X p ER 
onBind() 方 法 ,并 在 onBind() 方 法 中 返回 Service 实例 ,示例 代码 如 下 。 


public class MathService extends Service( 
private final IBinder mBinder- new LocalBinder(); 


1 

2 

3 

4 public class LocalBinder extends Binder( 
5 MathService getService() ( 

6 retum MathService.this; 

7 ) 

8 ) 

9 


10 G Override 

1 public IBinder onBind(Intent intent) { 
12 return mBinder; 

13 } 

14 ] 


当 Service 被 绑 定 时 ,系统 会 调用 onBind O 函数 ,通过 onBind O 函数 的 返回 值 ,将 
Service 实例 返回 给 调用 者 。 从 第 11 行 代码 中 可 以 看 出 ,onBind() 函 数 的 返回 值 必须 符合 
IBinder 接口 ,因此 在 代码 的 第 2 行 声明 一 个 接口 变量 mBinder,mBinder 符合 onBind OO 函数 
返回 值 的 要 求 , 因 此 可 将 mBinder 传递 给 调用 者 。IBinder 是 用 于 进程 内 部 和 进程 间 过 
程 调用 的 轻 量 级 接口 ,定义 了 与 远程 对 象 交互 的 抽象 协议 ,使 用 时 通过 继承 Binder 的 方 
法 来 实现 。 继 承 Binder 的 代码 在 第 4 行 ,LocalBinder 是 继承 Binder 的 一 个 内 部 类 ,并 在 
代码 第 5 行 实现 了 getService O PR Zt. 当 调 用 者 获取 mBinder 后 ,通过 调用 getService() 
即 可 获取 Service 实例 。 

调用 者 通过 bindService CO) 函数 绑 定 服务 ,并 在 第 1 个 参数 中 将 Intent 传递 给 
bindServiceC) 函数 ,声明 需要 启动 的 Service。 第 3 个 参数 Context. BIND_ AUTO_ 
CREATE 表明 只 要 绑 定 存在 ,就 自动 建立 Service; 同时 也 告知 Android 系统 ,这 个 
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Service 的 重要 程度 与 调用 者 相同 ,除非 考虑 终止 调用 者 ,否则 不 要 关闭 这 个 Service. 


1 final Intent serviceIntent- new Intent (this,MathService.class); 
2 bindService (servioeIntent,mConnection,Context.BIND AUTO CREATE); 


bindServiceO 函数 的 第 2 个 参数 是 ServiceConnnection。 当 绑 定 成 功 后 ,系统 将 调 
用 ServiceConnnection 的 onServiceConnected() 方 法 ;而 当 绑 定 意 外 断 开 后 ,系统 将 调用 
ServiceConnnection 中 的 onServiceDisconnected 方法 。 因 此 ,以 绑 定 方式 使 用 Service， 
调用 者 需要 声明 一 个 ServiceConnnection ,并 重 载 内 部 的 onServiceConnected() 方 法 和 
onServiceDisconnected 方法 ,两 个 方法 的 重 载 代码 如 下 。 


private ServiœConnection mConnection- new ServioeConnection() ( 

@ Override 

public void anServioeConnected CorponentName nare, TBinder service) ( 
mathService- ((MathService.LocalBinder)service) .getService () ; 


B 

2 

3 

4 

5 ) 
6 @ Override 

7 public void onServiceDisconnected (CamponentName name) ( 
8 mathService- null; 

9 ) 

10 F 


在 代码 的 第 4 行 中 , 绑 定 成 功 后 通过 getService() 获 取 Service 实例 ,这 样 便 可 以 调 
用 Service 中 的 方法 和 属性 。 代 码 第 8 行将 Service 实例 指定 为 null, 表 示 绑 定 意外 失效 
时 ,Service 实例 不 再 可 用 。 

取消 绑 定 仅 需 要 使 用 unbindService ( ) 方 法 ,并 将 ServiceConnnection 传递 给 
unbindService() 方 法 。 但 须要 注意 的 是 ,unbindService( ) 方 法 成 功 后 ,系统 并 不 会 调用 
onServiceDisconnected() ,因为 onServiceDisconnected() 仅 在 意外 断 开 绑 定时 才 被 调用 。 


Unbindservice (Connection) ; 


绑 定 方式 中 , 当 调 用 者 通过 bindService O 函数 绑 定 Service 时 ,onCreate() 函数 和 
onBindeO 函数 将 被 先后 调用 。 当 调用 者 通过 unbindService O PROBUS JB 4E Service 时 ， 
onUnbindO 函数 将 被 调用 。 如 果 onUnbind O 函数 返回 true, 则 表示 重新 绑 定 服务 时 ， 
onRebind O 函数 将 被 调用 。 绑 定 方式 的 函数 调用 顺序 如 图 7. 5 所 示 o 


调用 
esu ; SURG indo L| onDestroy 停止 
Pee onCreate() onBind() Service 交 五 onUnbind() | 一 | onDestroy() Si 


onRebind() 


图 7.5 SET XR A AARE 
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SimpleMathServiceDemo 是 以 绑 定 方式 使 用 Service 的 示例 。 在 示例 中 创建 了 
MathService 服务 ,用 来 完成 简单 的 数学 运算 ,这 里 的 数 
学 运算 仅 指 加 法 运算 ,虽然 没有 实际 意义 ,但 可 以 说 明 
如 何 使 用 绑 定 方式 调用 Service 中 的 公有 方法 。 在 服务 
绑 定 后 ,用 户 可 以 点 击 * 加 法 运算 ?按钮 将 两 个 随机 产 
生 的 数值 传递 给 MathService 服务 ,并 从 MathService 
实例 中 获取 加 法 运算 的 结果 ,然后 显示 在 屏幕 的 上 方 。 
“取消 绑 定 ”按钮 可 以 解除 与 MathService 的 绑 定 关系 ， 加 法 运算 
在 取消 绑 定 后 ,点 击 “ 加 法 运算 ?按钮 将 无 法 获取 运算 图 7.6 SimpleMathServiceDemo 
结果 。SimpleMathServiceDemo 的 用 户 界 面 如 图 7. 6 用 户 界面 
所 示 。 

在 SimpleMathServiceDemo 示例 中 , MathService. java 文件 是 Service 的 定义 文件 。 
SimpleMathServiceDemoActivity. java 文件 是 界面 的 Activity 文件 , 绑 定 服务 和 取消 绑 定 服务 
的 代码 在 这 个 文件 中 。 下 面 给 出 MathService. java 和 SimpleMathServiceDemoActivity. java 
文件 的 完整 代码 。 

MathService. java 文件 的 完整 代码 : 


| al SimpleMathServiceDemo 


取消 绑 定 


package edu.hrbeu.SimpleMathServioeDemo; 


1 

2 

3 import android.app.Servioe; 

4 import android.content.Intent; 
5 import android.os.Binder; 

6 inport android.os.IBinder; 

7 inport android.widget Toast; 

8 
9 


public class MathService extends Service( 


1 private final IBinder mBinder- new IocalBinder() ; 
2 

3 public class LocalBinder extends Binder( 

14 MathService getService() ( 

15 retum MathService.this; 

16 ) 

17 } 

18 

19 @ Override 

20 pdblic IBinder onBind(Intent intent) ( 

2 Toast.makeText (this，" 本 地 绑 定 : MathService", 
22 Toast.IENGIH SHORT) .show(); 

23 return mBinder; 


X 
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25 
26 @ Override 

21 public boolean onUnbind (Intent intent) ( 

28 Toast.makeText (this, "Hi ili Æ 48 Jf ;E : MathService", 
29 Toast.IENGIH SHORT) .show () ; 

30 return false; 

a ) 

3 

33 

3 public long Add (long a, long b)( 

35 return at b; 

36 ) 

3 

3 } 


SimpleMathServiceDemoActivity. java 文件 的 完整 代码 : 


package edu.hrbeu.SimpleMathServioeDemo; 


1 
2 
3 import android.arp.Activity; 
4 inport android.content..CamponentName; 
5 import android.content Context; 
6 import android.content.Intent; 
7 import android.content..ServiceConnection; 
8 — import android.os.Pundle; 

9 import android.os.IBinder; 

10 import android.view.View; 

1l — import android.widget.Button; 

12 import android.widget.TextView; 


13 

14 public class SimpleMathServiceDemActivity extends Activity ( 
15 private MathService mathService; 

16 private boolean isBound- false; 

17 TextView labelView; 

18 @ Override 

19 public void onCreate (Bundle savedInstanceState) { 

20 Super.onCreate (savedInstanceState) ; 

21 setContentView (R. layout .main); 

2 

23 labelView- (TextView) findViewById (R.id.label); 

24 Button bindButton- (Button) findViewById(R.id.bind) ; 
25 Button unbindButton- (Button)findViewByld |(R.id.uribind) ; 


26 Button camputButton- (Button) findViewByld|(R.id.campute); 
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bindButton.setOnClickListener (new View.OnClickListener () ( 
G Override 
public void onClick(View v) ( 
if('isBound)( 
final Intent servioeIntent- new Intent 
GinpleMvathServioeDemoictivity.this,MathService.class) ; 
bindService (servioemtent, Connection, Context.BIND AUTO CREMIE) ; 
isBound- true; 


DE 


unbindButton.setOnClickListener (new View.OnClickListener () ( 
G Override 
public void onClick (View v) ( 
if (isBound) { 
isBound- false; 
unbindService (rConnection) ; 
mathService- null; 


n; 


camputeButton.setonClickListener (new View.OnClickListener () ( 
G Override 
public void onClick(View v) ( 
if (mathService- = null) ( 
labelView.setText ("f 20 3E It 5$") ; 
retum; 
j 
long a- Mth. round Math. random () * 100); 
long b= Math. round (Math. random () * 100); 
long result=mathServiœ.Add (a, b); 
String msg- String.valueof (a)+ "+ "+ String.valueof (b)+ 
"= "+ String.valueOf (result) ; 
labelView.setText (msg) ; 


H; 


private ServiceConnection mConnection- new ServiceConnection() { 
@ Override 
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69 Piblic void cnServiceconnected(ComponentNEane nare, TRinder service) ( 
70 mathService- ((MathService.IocalBincer) service) .getService () ; 
"n ) 

z2 

B @ Override 

74 public void onServioeDisconnected (ComponentName name) { 

5 mathService- null; 

76 ) 

TI ) 


73 Zx 3E RK 2e 


远程 服务 的 调用 者 和 服务 在 不 同 的 进程 中 ,需要 跨 进程 才能 够 实现 服务 的 调用 。 远 
程 服务 同样 涉及 服务 的 建立 、 启 动 和 停止 ,不 同 之 处 在 于 需要 使 用 Android 系统 自 定义 
的 接口 描述 语言 AIDL 描述 远程 服务 ,并 使 用 Parcelable 接口 传递 用 户 自 定义 的 数据 。 
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在 Android 系统 中 ,每 个 应 用 程序 在 各 自 的 进程 中 运行 ,而 且 出 于 安全 原因 的 考虑 ， 
这 些 进程 之 间 彼 此 是 隔离 的 ,进程 之 间 传 递 数 据 和 对 象 ,需要 使 用 Android 支持 的 进程 
间 通 信 (Inter-Process Communication. IPC) 机 制 。 在 Unix/Linux 系统 中 ,传统 的 IPC 
机 制 包 括 共享 内 存 、 管 道 、 消 息 队 列 和 socket 等 ,这 些 IPC 机 制 虽然 被 广泛 使 用 ,但 仍然 
存在 着 固有 的 缺陷 ,如 容易 产生 错误 、 难 于 维护 等 。 在 Android 系统 中 ,没有 使 用 传统 的 
IPC 机 制 , 而 是 采用 Intent 和 远程 服务 的 方式 实现 IPC, 使 应 用 程序 具有 更 好 的 独立 性 和 
鲁 棒 性 。 

Android 系统 允许 应 用 程序 使 用 Intent 启动 Activity 和 Service, 同 时 Intent 可 以 传 
递 数据 ,是 一 种 简单 .高 效 、. 易 于 使 用 的 IPC 机 制 。Android 系统 的 另 一 种 IPC 机 制 就 是 
远程 服务 ,服务 和 调用 者 在 不 同 的 两 个 进程 中 ,调用 过 程 需要 跨越 进程 才能 实现 。 

在 Android 系统 中 使 用 远程 服务 ,一 般 按 照 以 下 三 个 步骤 实现 。 首 先 , 使 用 AIDL 
语言 定义 远程 服务 的 接口 。 然 后 根据 AIDL 语言 定义 的 接口 ,在 具体 的 Service 类 中 实 
现 接口 中 定义 的 方法 和 属性 。 最 后 在 需要 调用 远程 服务 的 组 件 中 ,通过 相同 的 AIDL 接 
口 文件 ,调用 远程 服务 。 
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在 Android 系统 中 ,进程 之 间 不 能 直接 访问 相互 的 内 存 空 间 , 因 此 为 了 使 数据 能 够 
在 不 同 进程 间 传 递 ,数据 必须 转换 成 能 够 穿越 进程 边界 的 系统 级 原 语 ,同时 ,在 数据 完成 
进程 边界 穿越 后 ,还 需要 转换 回 原 有 的 格式 。 
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AIDL(Android Interface Definition Language) 是 Android 系统 自 定义 的 接口 描述 
语言 ,可 以 简化 进程 间 数 据 格式 转换 和 数据 交换 的 代码 ,通过 定义 Service 内 部 的 公共 方 
法 ,允许 在 不 同 进程 的 调用 者 和 Service 之 间 相 互 传递 数据 。AIDL 的 IPC 机 制 .COM 和 
Corba 都 是 基于 接口 的 轻 量 级 进程 通信 机 制 。 

AIDL 语言 的 语法 与 Java 语言 的 接口 定义 非常 相似 ,唯一 不 同 之 处 在 于 ,AIDL 允许 
定义 函数 参数 的 传递 方向 。AIDL 支持 三 种 方向 : inout 和 inout, 标 识 为 in 的 参数 将 从 
调用 者 传递 到 远程 服务 中 ,标识 为 out 的 参数 将 从 远程 服务 传递 到 调用 者 中 ,标识 为 
inout 的 参数 将 先 从 调用 者 传递 到 远程 服务 中 ,再 从 远程 服务 返回 给 调用 者 。 如 果 不 标 
识 参数 的 传递 方向 ,默认 所 有 函数 的 传递 方向 为 in。 出 于 性 能 方面 的 考虑 ,不 要 在 参数 
中 标识 不 需要 的 传递 方向 。 

远程 服务 的 创建 和 调用 需要 使 用 AIDL 语言 ,一 般 分 为 以 下 几 个 过 程 : 

CD 使 用 AIDL 语言 定义 远程 服务 的 接口 。 

(2) 通过 继承 Service 类 实现 远程 服务 。 

(3) 绑 定 和 使 用 远程 服务 。 

下 面 以 RemoteMathServiceDemo 示例 为 参考 ,说 明 如 何 创 建 远程 服务 。 在 这 个 示 
例 中 定义 了 MathService 服务 ,可 以 为 远程 调用 者 提供 加 法 服务 。 


1. 使 用 AIDL 语言 定义 远程 服务 的 接口 


首先 使 用 AIDL 语言 定义 MathService 的 服务 接口 ,服务 接口 文件 的 扩展 名 为 . aidl， 
使 用 的 包 名 称 与 Android 项 目 所 使 用 的 相同 。 在 src 目录 下 建立 IMathService. aidl 文 
件 ,代码 如 下 。 


package edu.hrbeu.RemoteMathServioeDemo; 
interface IMathService { 
long Bod (lorng a, long b); 


» 
2 
3 
4 


} 


从 上 面 的 代码 中 可 以 看 出 ,IMathService 接口 仅 包含 一 个 add() 方 法 ,传人 的 参数 是 


Hi eduhrbeuRemoteMathSerdiceDemo 两 个 长 型 整数 ,返回 值 也 是 长 型 整数 。 
z 9 GE 使 用 Eclipse 编辑 IMathService. aidl 文件 ， 
A 当 保存 文件 后 Eclipse 的 ADT 插件 根据 AIDL 
6 9 asinterface(IBinder) : IMathService 文件 在 gen 目录 下 生成 java 接口 文件 


€ 4 asBinder() : IBinder " A 
@ onTransact(nt, Parcel, Parcel, in) : boolean | IMathService. java, 


ido aada IMathService java 文件 根据 IMathService. aidl 
piii UNE 的 定义 ,生成 了 一 个 内 部 静态 抽象 类 Stub, 如 图 

$9 getinterfaceDescriptor0 : String 7. 7 Br z&. Stub 继承 了 Binder 类 ,并 实现 
Poenis dori IMathService 接口 。 在 Stub 类 中 ,还 包含 一 个 重 

e Addiong. lon): koog 要 的 静态 类 Proxy。 可 以 认为 Stub 类 用 来 实现 


7.7 MathService, java 文件 结构 本 地 服务 调用 ,Proxy 类 用 来 实现 远程 服务 调用 ， 
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将 Proxy 作为 Stub 的 内 部 类 完全 是 出 于 使 用 方便 的 目的 。Stub 类 和 Proxy 类 关系 如 
图 7.8 所 示 。 


AIDL 3 $F 
IMathService.aidl 


AIDL 
IR 


生成 Java 接 口 文件 


IMathService.java 
生成 内 部 静态 抽象 Stub 类 
IMathService.Stub 
生成 内 部 


IMathService.Stub.Proxy 


本 地 服务 对 象 远程 服务 对 象 

StubasInterface() 用 来 返回 使 用 asinterface() 获 取 

远程 服务 对 象 (Proxy) 远程 Proxy 对 象 的 引用 

SM onTransact() Transact() E. 
IMathService.Stub | IMathService.Stub.Proxy 

TMathService asInterface(TBinder obj) TBinder asBinder() 

IBinder asBinder() String getlInterfaceDescriptor() 

boolean onTransact(int code, Parcel data, long Add(long a, long b) 

Parcel reply, int flags) 


7.8 Stub 类 和 Proxy 类 关系 图 


下 面 给 出 IMathService. java 的 代码 。 


package edu.hrbeu.RemoteMathServiceDemo; 
public interface IMathService extends android.os.IInterface( 
/**1ocal- side IFC implementation stub class. * / 
public static abstract class Stub extends android. os. Binder implements edu. hrbeu. 
RemoteMathServiceDemo. IMathService( 
private static final java.lang.String DESCRIPTOR= "edu.hrbeu 
-RemoteMathServiceDemo.IMathService"; 
6 /**Gonstruct the stub at attach it to the interface. * / 
7 public Stub() ( 
8 
9 


XE 


a 


this.attachInterface (this，DESCRIPTOR) ; 


10 px 

n * Cast an IBinder abject into an IMathService interface, 

12 * generating a proxy if needed. 

13 */ 

14 public static edu.hrbeu.RemoteMathServioeDamo. IMathService 
asInterface (android.os.IBinder obj){ 
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19 


B 


Gu 


LEE NT 


E 


名 


if ((dj--nul)) ( 
retum null; 
) 
android.os.IInterface iin- (android.os.IInterface) dj 
-queryLocal Interface (DESCRIPTOR) ; 
if ((Gin!-null)&& (iin instanoeof edu.hrbeu.RemoteMathServioeDemo 
-IMathService))) ( 
return ((edu.hrbeu.RemoteMathServioceDemo. IMathService) iin); 
) 
-Proxy (db) ; 
) 
public android.os.IBinder asBinder () ( 
retum this; 
} 
public boolean onTransact (int code, android.os.Parcel data, android.os 
.Parcel reply, int flags) throws android.os.RemoteException( 
switch (code) 1 
case INTEREACE. TRANSACTION: 
t 
reply.writeString (DESCRIPTOR) ; 
retum true; 
) 
case TRANSACTION Add: 
{ 
data.enforceInterface (DESCRIPTOR); 
long _arg0; 
. argo- data.readLong () 
long argl; 
. argl- data.readlLong () ; 
long result-this.&di( argü, argl); 
reply.writeNoExoeption() ; 
reply.writelong( result); 
retum true; 


) 

return super.onTransact (code, data, reply, flags); 
} 
private static class Proxy implements edu.hrbeu.RemoteMathServiceDemo 
-IMathService( 

private android.os.IBinder mRemote; 

Proxy (android.os.IBinder remote) { 

mRempbte- remte; 
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53 f 

54 public android.os.IBinder asBinder () ( 

55 return mRenote; 

56 } 

57 public java.lang.String getInterfaceDescriptor () ( 

58 return ESCRIPTOR; 

59 ) 

60 public long Add(long a, long b) throws android.os.RemoteExoeption( 
6L android.os.Parcel data- android.os.Parcel.cbtain(); 

e android.os.Parcel reply- android.os.Parcel.cbtain() ; 

6 long result; 

e try{ 

6 . data.writeInterfaceToken (DESCRIPTOR) ; 

66 . data.writelong(a); 

6 . data.writelong (b) ; 

6 rRemote.transact (Stub. TRANSACTION Add, data, reply, 0); 
69 . reply.readExoeption() ; 

70  result- reply.readLong(); 

n ) 

72 finally ( 

3 _reply.recycle(); 

74 . data.recycle () ; 

75 } 

76 retum — result; 

T ) 

7$. j 

79 static final int TRANSACTION Adè (IBinder.FIFST CALL TRANGACTION- 0); 
8 ] 

81 public long Add(long a, long b) throws android.os.RemoteExoeption; 

8 ] 


IMathService 继承 了 android. os. IInterface( 第 2 £1) ,这 是 所 有 使 用 AIDL 建立 的 接 
口 都 必须 继承 基 类 接口 ,这 个 基 类 接口 中 定义 了 asBinder() 方 法 ,用 来 获取 Binder 对 象 。 
代码 第 24 行 到 第 26 行 ,实现 了 android. os. Interface 接口 所 定义 的 asBinder() 方 法 。 
在 IMathService 中 , 绝 大 多 数 的 代码 是 用 来 实现 Stub 这 个 抽象 类 的 。 每 个 远程 接口 都 
包含 Stub 类 ,因为 是 内 部 类 ,所 以 并 不 会 产生 命名 冲突 。 

asInterface(IBinder) 是 Stub 内 部 的 远程 服务 接口 ,调用 者 可 以 通过 该 方法 获取 远程 
服务 的 实例 。 仔 细 观 察 asInterface(IBinder) 实 现 方法 ,首先 判断 IBinder 对 象 obj 是 否 为 
null 第 15 行 ,如 果 是 , 则 立即 返回 。 然 后 使 用 DESCRIPTOR 构造 android. os. Interface 
实例 第 18 行 ,并 判断 android. os. Interface 实例 是 否 为 本 地 服务 。 如 果 是 本 地 服务 , 则 
无 须 进 行进 程 间 通信 ,返回 android. os. IInterface 实例 第 20 行 ;如 果 不 是 本 地 服务 , 则 构 
造 并 返回 Proxy 对 象 第 22 行 。 
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Proxy 内 部 包含 与 IMathService. aidl 相同 签名 的 函数 (第 60 行 ), 并 且 在 该 函数 中 
以 一 定 的 顺序 将 所 有 参数 写 和 人 Parcel 对 象 (第 65 一 70 行 ) ,以 供 Stub 内 部 的 onTransact () 方 
法 能 够 正确 获取 参数 。 

当 数 据 以 Parcel 对 象 的 形式 传递 到 远程 服务 的 内 部 时 ,onTransact() 方 法 (第 27 行 ) 
将 从 Parcel 对 象 中 逐一 地 读 取 每 个 参数 ,然后 调用 Service 内 部 制定 的 方法 ,并 再 将 结果 
写 人 另 一 个 Parcel Xf 5 ,准备 将 这 个 Parcel 对 象 返回 给 远程 的 调用 者 。 

Parcel 是 Android 系统 中 应 用 程序 进程 间 数 据 传 递 的 容器 ,能 够 在 两 个 进程 中 完成 
数据 的 打包 和 拆 包 的 工作 ,但 Parcel 不 同 于 通用 意义 上 的 序列 化 ,Parcel 的 设计 目的 是 
用 于 高 性 能 IPC 传输 ,因此 不 能 够 将 Parcel 对 象 保存 在 任何 持久 存储 设备 上 。 


2. 通过 继承 Service 类 实现 远程 服务 


IMathService. aidl 是 对 远程 服务 接口 的 定义 ,自动 生成 的 IMathService. java 内 部 实 
现 了 远程 服务 数据 传递 的 相关 方法 ,下 一 步 介绍 如 何 实现 远程 服务 。 实 现 远程 服务 需要 
建立 一 个 继承 android. app. Service 的 类 ,并 在 该 类 中 通过 onBind() 方 法 返回 IBinder 对 
象 ,调用 者 使 用 返回 的 IBinder 对 象 访问 远程 服务 。IBinder 对 象 的 建立 通过 使 用 
IMathService. java 内 部 的 Stub 类 实现 ,并 逐一 实现 在 IMathService. aidl 接口 文件 定义 
的 函数 。 在 RemoteMathServiceDemo 示例 中 ,远程 服务 的 实现 类 是 MathService. java. 
下 面 是 MathService. java 的 完整 代码 。 


package edu.hrbeu.RemoteMathServioeDemo; 


1 

2 

3 import android.app.Service; 
4 import android.content..Intent; 
5 — import android.cs.IBinder; 

6 — import android.widget.Toast; 
M 
8 
9 


public class MathService extends Service( 
private final IMathService.Stub mBinder- new IMathService.Stub() { 


10 public long Add (long a, long b) ( 

1 retum atb; 

2 } 

13 IB 

14 @ Override 

15 public IBinder onBind (Intent intent) { 

16 Toast.makeText (this, "远程 绑 定 : MathService", 
17 Toast.IENGIH SHORT).show(); 

18 return mBinder; 

19 T 

20 G Override 

2 publicboolean onUnbind (Intent intent) { 

2 Toast.makeText (this，" 取 消 远 程 绑 定 : MathService", 
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23 Toast.IENGTH SHORT) .show(); 
24 retum false; 

25 ) 

26 } 


第 8 行 代 码 表 明 MathService 继承 于 android. app. Service, 56 9 行 建立 


IMathService. Stub 的 实例 mBinder, 并 在 第 10 
行 实现 了 AIDL 文件 定义 的 远程 服务 接口 。 第 
18 行 在 onBind() 方 法 中 ,将 mBinder 返回 给 远 
程 调用 者 。 第 16 行 和 第 22 行 分 别 是 在 绑 定 和 
取消 绑 定时 ,为 用 户 生 成 提示 信息 。 
RemoteMathServiceDemo 示例 的 文件 结构 
如 图 7.9 所 示 。 示 例 中 只 有 远程 服务 的 类 文件 
MathService. java 和 接口 文件 IMathService 
.aidl, 没 有 任何 显示 用 户 界面 的 Activity 文件 。 
因此 在 调试 RemoteMathServiceDemo 示例 时 ， 


4 $9 RemoteMathServiceDemo 
4 (9 src 
4 iB eduhrbeuRemoteMathServiceDemo 
» [D MathServicejava 
B IMathService.aidl 
4 $9 gen [Generated Java Files] 
4 册 edu hrbeu.RemoteMathServiceDemo 
» DD IMathServicejava 
> D Rjava 
b BÀ Android 4.0 
B assets 
» B bin 
» e res 
lij AndroidManifest.xml 
[3] proguard.cg 


project.properties 


模拟 器 上 不 会 有 任何 用 户 界 面 出 现 , 但 在 控制 
台 会 有 “没有 找到 用 于 启动 的 Activity, 仅 将 应 
用 程序 同步 到 设备 上 ”的 提示 信息 ,如 图 7.10 所 
示 , 表 明 . apk 文件 已 经 上 传 到 模拟 器 中 。 


Android Launch! 
adb is running normally. 

No Launcher activity found! 

The launch will only sync the application package on the device! 

Performing sync 

Automatic Target Mode: using existing emulator 'emulator-5554' running compatible AVD 'AndroidSim4.0" 
Uploading RemoteMathServiceDemo.apk onto device 'emulator-5554' 

Installing RemoteMathServiceDemo.apk... 

Success! 

MeenoteMathServiceDemoWbinMRemoteMathServiceDemo.apk installed on device 

Done! 


图 7.9  RemoteMathServiceDemo 
示例 文件 结构 


图 7. 10  RemoteMathServiceDemo 调试 信息 


为 了 进一步 确认 编译 好 的 . apk 文件 是 否 正确 上 传 到 模拟 器 中 ,可 以 使 用 File 
Explorer 查看 模拟 器 的 文件 系统 。 如 果 能 在 /data/app/ 下 找到 edu. hrbeu 
.RemoteMathServiceDemo. apk 文件 ,说 明 提 供 远 程 服务 的 . apk 文件 已 经 正确 上 传 。 
RemoteMathServiceDemo 示例 无 法 在 Android 模拟 器 的 程序 启动 栏 中 找到 ,只 能 够 通过 其 他 应 
用 程序 调用 该 示例 中 的 远程 服务 。 图 7. 11 显示 了 edu. hrbeu. RemoteMathServiceDemo. apk 文 
件 的 保存 位 置 。 

RemoteMathServiceDemo 是 本 书 中 第 一 个 没有 Activity 的 示例 ,在 AndroidManifest 
. xml 文件 中 ,在 二 application 过 标签 下 只 有 一 个 二 service 二 标签 。 

AndroidManifest. xml 文件 的 代码 如 下 。 
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Qi ApiDemos.apk 2597653 
B ApiDemos.odex 832872 
V CubeLiveWallpapers.apk 13230 
Bj CubeLiveWallpapers.odex 16536 
€) GestureBuilder.apk 18016 
B GestureBuilder.odex 22840 
QV SofiKeyboard.apk 23495 
B SofiKeyboard.odex 23848 
Q WidgetPreview.apk 14249 
Bj WidgetPreview.odex 12952 
V edu hrbeu.ImplicitRandomServiceDemo-2.apk 

V edu hrbeu.IntentResolutionDemo-L.apk 

QV edulhrbeu RemoteMathServiceDemo-L.apk. 

V edu hrbeu.SimpleMathServiceDemo-1.apk 

QV edukhrbeu.SimpleRandomServiceDemo-1.apk 

QV edukhrbeu.ThreadRandomServiceDemo-L.apk 


7.11. RemoteMathServiceDemo. apk 文件 位 置 


1 <?xml version- "1.0" encoding- "utf- 8"?» 
2 «manifest xmins:android- "http://schemas.android.con/apk/res/android" 
3 package- "edu.hrbeu.RemoteMathServioeDamo" 
4 android:versionCode- "1" 
5 android:versionName- "1.0" 
6 < application android:icon- "8 drawable/icon" android:label- 
"Q string/app name" 

7 < service android:name- ".MathService" 

android:process- ":rembte"» 
9 < intent- filter» 
10 < action android:name- "edu.hrbeu.RemoteMathServioeDemo 

-MathServioe"/» 

u < /intent- filter> 
12 </service> 
13 < /application» 
14 < uses- sdk android:minSdkVersion- "14"/» 
15  «/manifest^ 


这 里 注意 第 10 行 代码 ,edu. hrbeu. RemoteMathServiceDemo. MathService 是 远程 
调用 MathService 的 标识 ,调用 者 使 用 Intent. setAction O 函数 将 标识 加 入 Intent 中 , 然 
后 隐 式 启动 或 绑 定 服务 。 


3. 绑 定 和 使 用 远程 服务 


RemoteMathCallerDemo 示例 说 明 如 何 调用 RemoteMathServiceDemo 示例 中 的 远 
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程 服务 。RemoteMathCallerDemo 的 界面 如 图 7. 12 所 示 , 用 户 可 以 绑 定 远程 服务 ,也 可 
以 取消 服务 绑 定 。 在 绑 定 远程 服务 后 ,调用 RemoteMathServiceDemo 中 的 MathService 
服务 进行 加 法 运算 ,运算 的 输入 由 RemoteMathCallerDemo 随机 产生 ,运算 的 输入 和 结 
果 显 示 在 屏幕 的 上 方 。 

应 用 程序 在 调用 远程 服务 时 ,需要 具有 相同 的 Proxy 类 和 签名 调用 函数 ,这 样 才能 
够 使 数据 在 调用 者 处 打包 后 ,可 以 在 远程 服务 处 正确 拆 包 ,反之 亦 然 。 从 实践 角度 来 讲 ， 
调用 者 需要 使 用 与 远程 服务 端 相 同 的 AIDL 文件 。RemoteMathCallerDemo 示例 中 ,在 
edu. hrbeu. RemoteMathServiceDemo 包 下 引入 与 RemoteMathServiceDemo 相同 的 
AIDL 文件 IMathService. aidl, 所 以 在 gen. 目录 下 会 自动 生成 相同 的 IMathService. java 
文件 。RemoteMathServiceDemo 的 文件 结构 如 图 7. 13 所 示 。 


4 3 RemoteMathCallerDemo 
4 (9 src 
4 出 eduhrbeuRemoteMathCallerDemo 
B) RemoteMathCallerDemoActivityjava 
4 {B eduhrbeuRemoteMathServiceDemo 
国 IMathService.aidl 


4 $9 gen [Generated Java Files] 
4 出 eduhrbeuRemoteMathCallerDemo 
国 Rjava 


JB. edu.hrbeu.RemoteMathServiceDemo 
EB RemoteMathServiceDemo 

mÀ Android 40 

B assets 

& bin 

eres 

取消 服务 绑 定 回 AndroidManifestxml 

国 proguard.cfg 

国 project.properties 


加 法 运算 


E m ] D 


7.12. RemoteMathCallerDemo 用 户 界面 7.13 RemoteMathCallerDemo 的 文件 结构 


RemoteMathCallerDemoActivity. java 是 Activity 的 文件 ,远程 服务 的 绑 定 和 使 用 方 
法 与 7. 2. 3 节 的 本 地 服务 绑 定 示例 SimpleMathServiceDemo 相似 。 不 同 之 处 主要 包括 
以 下 两 处 。 一 是 使 用 IMathService 声明 远程 服务 实例 (代码 第 1 行 ); 二 是 通过 
IMathService. Stub 的 asInterface() 方 法 实现 获取 服务 实例 (代码 第 6 行 )。 


private IMathService mathService; 


1 
2 
3 private ServiceConnection mConnection- new ServioeConnection() ( 

4 @ Override 

5 public void onServioeOonnected (CaponentNeme rame, TBinder service) ( 
6 mathService- IMathService.Stub.asInterface (service); 

7 } 

8 @ Override 

9 public void onServiceDisconnected (CamponentName name) ( 
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10 mathService- null; 


绑 定 服务 时 ,首先 通过 setAction ) 方 法 声明 服务 标识 ,然后 调用 bindService() 绑 定 
服务 。 服 务 标识 必须 与 远程 服务 在 AndroidManifest. xml 文件 中 声明 的 服务 标识 完全 相 
同 。 因 此 本 示例 的 服务 标识 为 edu. hrbeu. RemoteMathServiceDemo. MathService. 与 远 
程 服务 示例 RemoteMathServiceDemo 在 AndroidManifest. xml 文件 声明 的 服务 标识 
一 致 。 


final Intent serviceIntent- new Intent () ; 

2 serviceIntent.setAction ("edu.hrbeu.RemoteMathServioeDermo 
.MathService"); 

3  bindService(serviceIntent,mConnection,Context.BIND AUTO CREATE); 


下 面 给 出 RemoteMathCallerDemoActivity. java 文件 的 完整 代码 。 


package edu.hrbeu.RemoteMathCallerDemo; 


import edu.hrbeu.RemoteMathServiceDemo. IMathService; 


import android.content.CamponentName; 
import android.content.Context; 
import android.content.Intent; 
import android.content.ServiceConnection; 
10 import android.cs.Bundle; 
ll import android.cs.IBinder; 
12 import android.os.RembteExoeption; 
13 import android.view.View; 
14 import android.widget.Button; 
15 import android.widget.TextView; 


Y 
2 
3 
4 
5 inport ardroid.arp.Activity; 
6 
3 
8 
9 


16 

17  pdblic class RemoteMathCallerDemoActivity extends Activity ( 

18 private IMathService mathService; 

19 

20 private ServiceConnection mConnection- new ServiceConnection() ( 

2 @ Override 

22 public void anServiceConnected Opanent Nane nane, TBinder service) { 
23 mathService- IMathService.Stub.asInterface (service) ; 

24 ] 


25 @ Override 
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public void onServiceDisconnected (CamponentName name) ( 
mathService- null; 


E 


private boolean isBound- false; 

TextView labelView; 

G Override 

public void onCreate (Bundle savedInstanceState) ( 
super .onCreate (savedInstanceState) ; 
setContentView (R. layout main) ; 


labelView- (TextView)findViewById(R.id.label); 

Button bincButton- (Button) findViewById(R.id.bind); 

Button unbindButton= (Button) findViesiById(R.id.unbind) ; 
Button oomputButton- (Button)findViewById(R.id.campute add); 


bindButton.setonClickListener (new View.OnClickListener() ( 
G Override 
public void onClick (View v) { 
if (!isBound) { 

final Intent servioeIntent- new Intent () ; 
serviceIntent .setAction ("edu.hrbeu 
-FemoteMathServiceDemo.MathService") ; 
bindService (serviceIntent,mConnection, Context 
.BIND AUTO CREATE); 
isBound- true; 


n; 


unbindButton.setOnClickListener (new View.OnClickListener () ( 
G Override 
public void onClick(View v) ( 
if (isBound) { 
isBound- false; 
unbindService (rConnection) ; 
mathService- null; 


pn 


camputeButton.setonClickListener (new View.OnClickListener() { 
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67 @ Override 

68 public void onClick (View v) { 

69 if (mathService- - null) ( 

70 labelView.setText "R Bp 4E Je Fe LAS"); 
7 retum; 

2 } 

B long a- Math. round (Math. random () * 100) ; 

74 long b- Math. round (Math. random () * 100); 

75 long result- 0; 

76 try{ 

TI result=mathServiœ.Add (a, b); 

78 } catch (RemoteExoeption e) ( 

79 e.printStackTrace() ; 

80 ) 

8l String msg- Strirg.valueof (a) * "+ "+ String.valueof (b)+ 
82 "= "+ String.valueof (result); 
83 labelView.setText (msg) ; 

84 ) 

85 p; 

86 } 

8 } 


733 数据 传递 


在 Android 系统 中 ,进程 间 传 递 的 数据 包括 Java 语言 支持 的 基本 数据 类 型 和 用 户 自 
定义 的 数据 类 型 ,为 了 使 数据 能 够 穿越 进程 边界 ,所 有 数据 都 必须 是 “可 打包 ?的 。 对 于 
Java 语言 的 基本 数据 类 型 ,打包 过 程 是 自动 完成 的 。 但 对 于 自 定义 的 数据 类 型 ,用 户 则 
需要 实现 Parcelable 接口 ,使 自 定义 的 数据 类 型 能 够 转换 为 系统 级 原 语 保存 在 Parcel 对 
Sp ,穿越 进程 边界 后 可 再 转换 为 初始 格式 。AIDL 支持 的 数据 类 型 见 表 7. 1 。 


表 7.1 AIDL 支持 的 数据 类 型 


类 型 说 明 需要 引入 
Java 语言 的 基本 类 型 包括 boolean byte、short ,int float 和 double 等 T 
String java. lang. String T 
CharSequence java. lang. CharSequence T 
List 其 中 所 有 的 元 素 都 必须 是 AIDL 支持 的 数据 类 型 否 
Map 其 中 所 有 的 键 和 元 素 都 必须 是 ADL 支持 的 数据 类 型 m 
其 他 AIDL 接口 任何 其 他 使 用 AIDL 语言 生成 的 接口 类 型 是 
Parcelable Xj 4% 实现 Parcelable 接口 的 对 象 是 


下 面 以 ParcelMathServiceDemo 示例 为 参考 ,说明 如 何在 远程 服务 中 使 用 自 定义 
数据 类 型 。 这 个 示例 是 RemoteMathServiceDemo 示例 的 延续 ,也 定义 了 MathService 
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服务 ,同样 可 以 为 远程 调用 者 提供 加 法 服务 。 
而 且 同 样 也 是 没有 启动 界面 ,因此 在 模拟 器 的 
调试 过 程 与 RemoteMathServiceDemo 示例 
相同 。 

不 同 之 处 在 于 MathService 服务 增加 了 “全 
运算 "功能 ,在 接收 到 输入 参数 后 ,将 向 调用 者 返 
回 一 个 包含 “加 \ 减 . 乘 、 除 ?全 部 运算 结果 的 对 象 。 
这 个 对 象 是 一 个 自 定 义 的 类 ,为 了 能 够 使 其 他 
AIDL 文件 可 使 用 这 个 自 定 义 类 ,需要 使 用 AIDL 
语言 声明 这 个 类 。 

ParcelMathServiceDemo 示例 的 文件 结构 如 
图 7.14 所 示 。 

首先 建立 AllResult. aidl X fff. 声明 
AllResult 类 。 在 第 2 行 代码 中 使 用 parcelable 声 
明 自 定义 类 ,这 样 其 他 的 AIDL 文件 就 可 以 使 用 
这 个 自 定义 的 类 。AllResult. aidl 文件 的 代码 
如 下 。 


4 3 ParcelMathServiceDemo| 
4 (9 src 
4 i eduhrbeu.ParcelMathServiceDemo 
» D AllResultjava 
b 国 MathServicejava 
B AllResultaidl 
E IMathService.aidl 
4 $9 gen [Generated Java Files] 
4 [B edu.hrbeu.ParcelMathServiceDemo 
» [D IMathServicejava 
» D Rjava 
» mÀ Android 4.0 
D assets 
» E bin 
» 8 res 
B AndroidManifestxml 
[8] proguard.cfg 
project.properties 


A ee C 


7.14  ParcelMathServiceDemo 
示例 的 文件 结构 


EL package edu.hrbeu.ParcelMathServioeDemo; 
2 parcelable AllResult; 


在 IMathService. aidl 文件 中 ,代码 第 6 行为 全 运算 增加 了 新 的 函数 ComputeAll()， 
该 函数 的 返回 值 就 是 在 AllResult. aidl 文件 中 定义 AllResult。 同 时 ,为 了 能 够 使 用 自 定 
义 数 据 结构 AllResult, 在 代码 中 须 引 入 edu. hrbeu. ParcelMathServiceDemo. AllResult 
包 。 第 2 行 和 第 6 行 是 新 增 的 代码 ,其 他 的 代码 与 RemoteMathServiceDemo 示例 相同 。 


package edu.hrbeu.ParcelMathServiceDemo; 


interface IMathService { 

long Add (long a, long b); 

AllResult CamputeAll (long a, long b); 
} 


oO € o wm on 


import edu.hrbeu. ParcelMathServiceDemo.Al Result; 


在 AIDL 文件 定义 完毕 后 ,下 一 步 介 绍 如 何 构造 AllResult 2$. AllResult 类 除了 基 
本 的 构造 函数 以 外 ,还 需要 以 Parcel 对 象 为 输入 的 构造 函数 ,并 且 需 要 重 载 打包 函 数 


writeToParcelO ) 。 


AllResult. java 文件 的 完整 代码 如 下 。 
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package edu.hrbeu.ParcelMathServioceDemo; 


inport android.os.Paroel; 
inport android.os.Paroelable; 


public class AllResult implements Parcelable ( 
public long A&ddResult; 
public long SubResult; 
public long MilFesult; 
public double DivResult; 


public AllResult (long accRusult, long sutResult, long milResult, 
dable divResult){ 

RaaResult= adcRusult; 

SubResult= sutResult; 

MilResult- milResult; 

DivResult- divResult; 


public AllResult (Parcel parcel) { 
AddResult- parcel .readLong() ; 
SubResult- parcel.readLong() ; 
MulResult- parcel.readlong() ; 
DivResult- parcel .readDouble () ; 


@ Override 
public int describeContents() ( 
return 0; 


@ Override 
public void writeToParcel(Parcel dest, int flags) { 
dest .writelong (aaaResult)7 
dest.writeLong (SubFesult) ; 
dest.writelong (MilFesult) ; 
dest.writeDoible (DivResult) ; 


public static final Parcelable.Creator« AllResult^ | CREATOR- 
new Parcelable.Creator« AllResult^ () f 
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a public AllResult createFramParcel (Parcel parcel) { 
42 retum new AllResult (parcel) ; 

43 } 

44 public AllResult[] newArray (int size) { 

45 retum new AllResult [size]; 

46 } 

47 ) 

4 0) 


代码 第 6 行 说 明了 AllResult 类 继承 于 Parcelable。 代 码 第 7 行 到 第 10 行 用 来 保存 
全 运算 的 运算 结果 。 第 12 行 是 AllResult 类 的 基本 构造 函数 。 第 19 行 也 是 类 的 构造 函 
数 , 支 持 Parcel 对 象 实例 化 AllResult。 代 码 第 32 行 的 writeToParcel() 是 “打包 ”函数 ， 
将 AllResult 类 内 部 的 数据 ,按照 特定 的 顺序 写 和 人 Parcel 对 象 , 写 人 的 顺序 必须 与 构造 函 
数 的 读 取 顺序 一 致 (代码 第 20 行 到 第 23 行 )。 第 39 行 实现 了 静态 公共 字段 Creator. Hl 
来 使 用 Parcel 对 象 构 造 AllResult 对 象 。 

在 MathService. java 文件 中 ,增加 了 用 来 进行 全 运算 的 ComputAll() 函数 ,并 将 运 
算 结果 保存 在 AllResult 对 象 中 。 

MathService. java 文件 中 的 ComputAll() 函数 实现 代码 如 下 。 


1 G Override 

2 public AllResult CamputeAll (long a, long b) throws RemoteExoeption ( 

3 long acdEusult- at b; 

4 long subResult- a -b; 

5 long müResult-a * b; 

6 double divResult- (double) a/ (double)b; 

7 AllResult allResult- new AllResult (addRusult, subResult, mulResult, 
divResult); 

8 return allResult; 

9 ) 


ParcelMathCallerDemo 示例 是 ParcelMathServiceDemo 示例 中 MathService 服务 的 
调用 者 , 文件 结构 如 图 7. 15 Bros. KP. AllResult. aidl, AllResult. java 和 
IMathService. aidl 文件 务必 与 ParcelMathServiceDemo 示例 的 三 个 文件 完全 一 致 ,否则 
会 出 现 错误 。 

在 图 7. 16 的 ParcelMathCallerDemo 界面 中 可 以 发 现 ,原来 的 “加 法 运算 ”按钮 改 为 
了 “全 运算 "按钮 ,运算 结果 显示 在 界面 的 上 方 。 

下 面 仅 给 出 ParcelMathCallerDemo. java 文件 与 RemoteMathCallerDemo 示例 
RemoteMathCallerDemoActivity. java 文件 不 同 的 代码 段 。 定 义 了 “全 运算 ”按钮 的 监 
听 函 数 , 随 机 产生 输入 值 ,调用 远程 服务 ,获取 运算 结果 ,并 将 运算 结果 显示 在 用 户 
界面 上 。 
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I$ Package Explorer 23 Bggle--u 
XS ParcelMathCallerDemo 
S src 

8B edu.hrbeu.ParcelMathCallerDemo 
国 ParcelMathCallerDemoActivityjava 

8B edu.hrbeu.ParcelMathServiceDemo 
国 AllResultjava 
B AllResult.aidl 


$8 gen [G j 
E edu.hrbeu.ParcelMathCallerDemo 
D Rjava 
册 edu.hrbeu.ParcelMathServiceDemo 
[) IMathservicejava 
mÀ Android 40 


B assets 


E» bin 
B res 
j| AndroidManifest.xml 
8] proguard.cfg 
B projectproperties 


4 mn , 


7.15  ParcelMathCallerDemo 的 文件 结构 7.16  ParcelMathCallerDemo 用 户 界面 


1 omputeAllButton.setOnClickListener (new View.OnClickListener () ( 
2 @ Override 


3 public void onClick(View v) ( 

4 if (mathService- - null) ( 

5 labelView.setText (v p s ire Fe I 5$); 

6 retum; 

7 } 

8 long a=Math. round Math. random() * 100); 

9 long b=Math. round Math. random() * 100); 

10 AllResult result- null; 

u try { 

12 result-mathService.CamputeALl (a, b); 

13 ) catch (RemoteException e) ( 

14 e.printStackTrace() ; 

15 ] 

16 String msg- ""; 

17 if (result !'-null)( 

18 Imsg+ = String.valueOf (a) - "+ "+ String.valueOf (b)+ "= "+ String 
-ValueOf (result.AddResult)-* "An"; 

19 msg* = String.valueOf (a) *- " - "+ String.valueof (b)+ "= "+ 
String.valueOf (result.SubResult)* "An"; 

20 msg+ = String.valueOf (a) " * "+ String.valueOf (b)+ "= "+ 
String.valueOf (result.MilResult)- "An"; 

21 msg* = String.valueof (a) "/ "+ String.valueOf (b)+ "= 


String.valueOf (result.DivResult); 
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24 } 
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l. 简 述 Service 的 基本 原理 和 用 途 。 

2. 编程 建立 一 个 简单 的 进程 内 服务 ,实现 比较 两 个 整数 大 小 的 功能 。 服 务 提供 
Int Compare(Int, Int) 函 数 ,输入 两 个 整数 ,输出 较 大 的 整数 。 

3. 使 用 AIDL 语言 实现 功能 与 第 2 题 相同 的 跨 进程 服务 。 


第 SA char eo AEO 
数据 存储 与 访问 


Android 系统 提供 多 种 数据 存储 方法 ,包括 易于 使 用 的 SharedPreferences、 经 典 的 文 
件 存储 和 轻 量 级 的 SQLite 数据 库 , 不 同 的 数据 存储 方法 有 着 不 同 的 适用 领域 。 通 过 本 
章 的 学 习 可 以 让 读者 了 解 Android 系统 各 种 数据 存储 方法 的 特点 和 使 用 方法 ,掌握 跨 进 
程 的 数据 共享 方法 。 

本 章 学 习 目 标 : 

。 掌握 SharedPreferences 的 使 用 方法 ; 

。 掌握 各 种 文件 存储 的 区 别 与 适用 情况 ; 

* 了 解 SQLite 数据 库 的 特点 和 体系 结构 ; 

。 FHE SQLite 数据 库 的 建立 和 操作 方法 ; 

* 理解 ContentProvider 的 用 途 和 原理 ; 

。 掌握 ContentProvider 的 创建 与 使 用 方法 。 
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简单 存储 指 的 是 Android 系统 提供 的 轻 量 级 的 数据 保存 方式 SharedPreferences ,将 
数据 以 最 简单 的 方式 进行 永久 性 保存 。SharedPreferences 屏蔽 了 对 底层 的 文件 操作 ,为 
程序 开发 人 员 提 供 简单 的 程序 接口 ,实现 基于 关键 字 的 数据 保存 。 


81.1 SharedPreferences 


在 应 用 程序 的 使 用 过 程 中 ,用 户 经 常会 根据 自己 的 习惯 更 改 应 用 程序 的 设置 ,或 者 
根据 自己 的 喜好 设 定 个 性 化 内 容 。 为 了 能 保存 配置 信息 和 个 性 化 内 容 , 应 用 程序 一 般 在 
文件 系统 中 保存 一 个 配置 文件 ,并 在 每 次 程序 启动 时 读 取 配置 文件 的 内 容 。 

在 文件 系统 中 使 用 配置 文件 ,需要 注意 配置 文件 的 格式 ,一 般 使 用 INI 文 件 或 XML 
文件 ,当然 也 可 以 自 定义 文件 格式 。INI 文件 格式 简单 ,容易 读 懂 , 但 须 使 用 代码 实现 文 
件 读 取 和 写 人 。XML 文件 有 成 熟 的 类 支持 ,在 代码 方面 更 容易 实现 ,但 可 读 性 上 要 比 
INI 文 件 差 一 些 。 无 论 是 使 用 INI 文 件 ,还 是 使 用 XML 文件 保存 配置 信息 和 个 性 化 内 
容 ,程序 开发 人 员 都 需要 进行 繁琐 的 编码 实现 文件 读 写 操作 。 
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Android 为 开发 人 员 提 供 了 更 为 简单 的 数据 存储 方法 SharedPreferences。 这 是 一 种 
轻 量 级 的 数据 保存 方式 ,通过 SharedPreferences 开发 人 员 可 以 将 NVP (Name/Value 
Pair, 名 称 / 值 对 ) 保 存在 Android 的 文件 系统 中 ,而 且 SharedPreferences 完全 屏蔽 了 对 
文件 系统 的 操作 过 程 , 开 发 人 员 仅 通过 调用 SharedPreferences 中 的 函数 就 可 以 实现 对 
NVP 的 保存 和 读 取 。 

SharedPreferences 不 仅 能 够 保存 数据 ,还 能 够 实现 不 同 应 用 程序 间 的 数据 共享 。 
SharedPreferences 支持 三 种 访问 模式 : 私有 (MODE_PRIVATE)、 全 局 读 CMODE _ 
WORLD_ READABLE) 和 全 局 写 (MODE WORLD WRITEABLE)。 如 果 将 
SharedPreferences 定义 为 私有 模式 , 仅 创建 SharedPreferences 的 程序 有 权限 对 其 进行 读 
取 或 写 人 ;如果 将 SharedPreferences 定义 为 全 局 读 模 式 , 不 仅 创 建 程序 可 以 对 其 进行 读 
取 或 写 人 ,其 他 应 用 程序 也 具有 读 取 操作 的 权限 ,但 没有 写 人 操作 的 权限 ;如 果 将 
SharedPreferences 定义 为 全 局 写 模式 , 则 所 有 程序 都 可 以 对 其 进行 写 入 操作 ,但 没有 读 
取 操 作 的 权限 。 

在 使 用 SharedPreferences 前 , 先 定义 SharedPreferences 的 访问 模式 。 下 面 的 代码 
将 访问 模式 定义 为 私有 模式 : 


public static int MODE- MODE. PRIVATE; 


有 的 时 候 需要 将 SharedPreferences 的 访问 模式 设 定 为 既 可 以 全 局 读 ,也 可 以 全 局 
写 , 这 就 需要 将 两 种 模式 写成 下 面 的 方式 : 


public static int MODE- Context.MODE WORLD READABIE+ Context.MOFE WORLD WRITEABIE; 


除了 定义 SharedPreferences 的 访问 模式 ,还 要 定义 SharedPreferences 的 名 称 , 这 个 
名 称 也 是 SharedPreferences 在 Android 文件 系统 中 保存 的 文件 名 称 。 一 般 将 
SharedPreferences 名 称 声明 为 字符 串 常量 ,这 样 可 以 在 代码 中 多 次 使 用 : 


public static final String PREFERENCE NAME- "SaveSetting"; 


使 用 SharedPreferences 时 需要 将 访问 模式 和 SharedPreferences 名 称 作 为 参数 传递 
到 getSharedPreferences() 函 数 , 则 可 获取 SharedPreferences 实例 。 


SharedPreferences sharedPreferences- getSharedPreferences (PREFERENCE. NAME, MXE); 


在 获取 SharedPreferences 实例 后 , 可 以 通过 SharedPreferences. Editor 类 对 
SharedPreferences 进行 修改 ,最 后 调用 commit() 函 数 保存 修改 内 容 。SharedPreferences 
广泛 支持 各 种 基本 数据 类 型 ,包括 整 型 ,布尔 型 、 浮 点 型 和 长 型 等 。 


1 SharedPreferences.EFditor editor- sharedPreferences.edit () ; 
2 editor.putString("Name", "Tam"); 
3 editor.putInt "Age", 20); 
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4 editor.putFloat ("Height", 1.81f); 
5 editor.camit() ; 


如 果 需 要 从 已 经 保存 的 SharedPreferences 中 读 取 数据 ,同样 是 调用 getShared- 
Preferences() 函数 ,并 在 函数 的 第 1 个 参数 中 指明 需要 访问 的 SharedPreferences 名 称 , 最 后 
通过 get— Type > O RAK PURT TE. SharedPreferences 中 的 NVP, get— Type > O PR Zi fg 
第 1 个 参数 是 NVP 的 名 称 ,第 二 个 参数 是 默认 值 ,在 无 法 获取 数值 时 使 用 。 


SharedPreferences sharedPreferences- getSharedPreferences (RERNE NE, MIE); 
String name= sharedPreferences.getString ("Name", "Default. Name") ; 

int age- sharedPreferences.getInt ("Age", 20); 

float height= sharedPreferences.getFloat ("Height",1.81f) ; 


& 0o PP 
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至 此 已 经 介绍 了 SharedPreferences 的 使 用 方法 ,下 面 将 通过 SimplePreferenceDemo 
示例 介绍 SharedPreferences 的 文件 保存 位 置 和 保存 格式 。SimplePreferenceDemo 示例 
的 用 户 界面 如 图 8. 1 所 示 ,用户 在 界面 上 的 输入 信 
息 ,在 Activity 关闭 时 通过 SharedPreferences 进 
行 保存 。 当 应 用 程序 重新 开启 时 ,再 通过 
SharedPreferences 将 信息 读 取出 来 ,并 重新 呈现 在 
用 户 界面 上 。 nis 

SimplePreferenceDemo 示例 运行 并 通过 “ 回 退 
键 ? 退 出 后 ,通过 FileExplorer 查看 /data/data 下 8.1 SimplePreferenceDemo 用 户 界面 
的 数据 ,Android 系统 为 每 个 应 用 程序 建立 了 与 包 
同名 的 目录 ,用 来 保存 应 用 程序 产生 的 数据 文件 ,包括 普通 文件 ,SharedPreferences 文件 
和 数据 库 文 件 等 。SharedPreferences 产生 的 文件 就 保存 在 /data/data/ 二 package name> 
/shared_prefs 目录 下 。 

在 本 示例 中 ,shared_prefs 目录 中 生成 了 一 个 名 为 SaveSetting. xml 的 文件 ,如 图 8.2 所 
7R ,保存 在 /data/ data/ edu. hrbeu. SimplePreferenceDemo/shared_prefs 目录 下 。 这 个 文件 就 
是 保存 SharedPreferences 的 文件 ,文件 大 小 为 170 字 节 ,在 Linux 下 的 权限 为 -rw-rw-rw。 


[a SimplePreferenceDemo 


Tom 


wi-I*€"-- 


Name Size Date Time Permissions Info ^ 
4 © edu.hrbue.SimplePreferenceDemo 2011-10-23 1019 drwxr-x--x 
& lib 2011-10-23 1011 drwxr-xr-x 
4 © shared prefs 2011-10-23. 1019 drwxwx-x 
E SaveSetting.xml 170 2011-10-23 10:19 -rw-rw-rw- 
© jp.co.omronsoft.openwnn 2011-10-20 0938 drwxr--x 3 
© dontpanic 2011-10-20 09336 drwxr-x--- 
& drm 2011-10-20 09336 _drwxrwxr-- - 


«T m ] » 


图 8.2 SaveSetting. xml 文件 
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在 Linux 系统 中 ,文件 权限 分 别 描述 了 创建 者 、 同 组 用 户 和 其 他 用 户 对 文件 的 操 
作 限 制 。x 表 示 可 执行 ,r 表示 可 读 ,w 表示 可 写 ,d 表示 目录 ,一 表示 普通 文件 。 因 此 ， 
-rw-rw-rw 表示 SaveSetting. xml 可 以 被 创建 者 、 同 组 用 户 和 其 他 用 户 进行 读 取 和 写 入 操 
作 , 但 不 可 执行 。 产 生 这 样 的 文件 权限 与 程序 人 员 设 定 的 SharedPreferences 的 访问 模式 
有 关 ,-rw-rw-rw 的 权限 是 “全 局 读 十 全 局 写 ” 的 结果 。 如 果 将 SharedPreferences 的 访问 
模式 设置 为 私有 , 则 文件 权限 将 成 为 -rw-rw 一 ,表示 仅 有 创建 者 和 同 组 用 户 具 有 读 写 文 
件 的 权限 。 

SaveSetting. xml 文件 是 以 XML 格式 保存 的 信息 ,其 代码 如 下 。 


<?xml version- "1.0" encoding- 'utf- 8' standalone- "yes"?> 
«map» 

< float name- "Height" value= "1.81"/» 

< string name= "Name"> Ta /string» 

< int name- "Age" value= "20"/» 


à 
2 
3 
4 
5 
6 <m 


SimplePreferenceDemo 示例 在 onStart O 函数 中 调用 loadSharedPreferences O 函数 ， 
读 取保 存在 SharedPreferences 中 的 姓名 、 年 龄 和 身高 信息 ,并 显示 在 用 户 界面 上 。 当 
Activity 关闭 时 ,在 onStop() 函数 调用 saveSharedPreferences() ,保存 界面 上 的 信息 。 下 
面 给 出 示例 的 完整 代码 。 

SimplePreferenceDemoActivity. java 的 完整 代码 。 


package edu.hrbeu.SimplePreferenceDemo; 


1 
2 
3 — import android.app.Activity; 

4 import android.content Context; 

5 — import android.content..SharedPreferences; 
6 import android.os.Bundle; 

7 inport ardroid.widget.EditText; 

8 

9 


public class SimplePreferenceDemoActivity extends Activity { 


1 private EditText nameText; 

12 private EditText ageText; 

13 private EditText heightText; 

14 public static final String PREFERENCE NAME- "SaveSetting"; 

15 pdblic static int MXE- Context.MODE WORLD READABIE+ Context.MODE WORLD 
 WRITEAHIE; 

16 

17 GOverride 

18 public void onCreate (Bundle savedInstanceState) { 


19 Super .onCreate (savedInstanceState) ; 
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setContentView (R. layout..main) ; 
nameText- (EditText) finaViesById(R.id.name) ; 
ageText- (EditText) finaViewByTd(R. id.age) ; 
heightText- (EditText) findViesById(R.id.height); 


GOverride 

public void onStart () ( 
super.onStart () ; 
loadSharedPreferences () ; 

) 

GOverride 

public void onStop () ( 
Super.onStop() ; 
saveSharedPreferences () 7 


private void loadSharedPreferences () ( 
SharedPreferenoes sharedPreferenoes- getSharedPreferenoes (EFEEERENCE. 
_NM, MIE); 
String name= sharedPreferences .getString ("Name", "Tom") ; 
int age- sharedPreferences.getInt ("Age", 20); 
float height= sharedPreferences.getFloat ("Height",1.81£) ; 


nameText .setText (name) ; 


ageText.setText (String.valueof (age) ) ; 
heightText.setText (String.valueOf (height)); 


private void saveSharedPreferences () ( 
SharedPreferences sharedPreferences- getSharedPreferences 
(PREFERENCE NAME, MXE); 
SharedPreferences.Editor editor- sharedPreferences.edit () ; 


editor.putString "Name", nameText .get Text () .toString()) ; 
editor.putInt ("ge", Integer.parseImt (ageText .getext () -toString ()))7 
editor.putFloat ("Height", Float.parseFloat (heightText.getText () 
-toString())); 

editor.camit () ; 
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虽然 SharedPreferences 能 够 为 开发 人 员 简 化 数据 存储 和 访问 过 程 ,但 直接 使 用 文件 
系统 保存 数据 仍然 是 Android 数据 存储 中 不 可 或 缺 的 组 成 部 分 。Android 使 用 Linux 的 
文件 系统 ,开发 人 员 可 以 建立 和 访问 程序 自身 建立 的 私有 文件 ,也 可 以 访问 保存 在 资源 
目录 中 的 原始 文件 和 XML 文件 ,还 可 以 将 文件 保存 在 TF 卡 等 外 部 存储 设备 中 。 
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Android 系统 允许 应 用 程序 创建 仅 能 够 自身 访问 的 私有 文件 ,文件 保存 在 设备 的 内 
部 存储 器 上 ,在 Android 系统 下 的 /data/data/ 二 package name /files 目录 中 。Android 
系统 不 仅 支 持 标准 Java 的 IO 类 和 方法 ,还 提供 了 能 够 简化 读 写 流 式 文件 的 函数 。 这 里 
主要 介绍 两 个 函数 openFileOutput() 和 openFileInput() 。 
openFileOutput() 函 数 为 写 入 数据 做 准备 而 打开 文件 。 如 果 指 定 的 文件 存在 ,直接 
打开 文件 准备 写 人 数据 ;如 果 指 定 的 文件 不 存在 , 则 创建 一 个 新 的 文件 。 
openFileOutput() 函 数 的 语法 格式 如 下 。 


public FileOutputStream openFileOutput (String name, int mode) 


第 1 个 参数 是 文件 名 称 , 这 个 参数 不 可 以 包含 描述 路 径 的 斜 枉 。 第 2 个 参数 是 操作 
模式 ,Android 系统 支持 4 种 文件 操作 模式 ,如 表 8. 1 所 示 。 函 数 的 返回 值 是 File- 
OutputStream 类 型 。 

表 8.1 4 种 文件 操作 模式 
Box 说 明 


私有 模式 ,缺陷 模式 ,文件 仅 能 够 被 创建 文件 的 程序 访问 ,或 具有 
相同 UID 的 程序 访问 


MODE_APPEND 追加 模式 ,如 果 文 件 已 经 存在 , 则 在 文件 的 结尾 处 添加 新 数据 
MODE WORLD READABLE | 全 局 读 模 式 ,允许 任何 程序 读 取 私有 文件 
MODE WORLD WRITEABLE | 全 局 写 模式 ,允许 任何 程序 写 和 人 私有 文件 


MODE_PRIVATE 


使 用 openFileOutput( 〇 函数 建立 新 文件 的 示例 代码 如 下 。 


String FILE NAME- "fileDemo.txt"; 

FileOutputStream fos- gpenFileOutput(FILE NAME,Context.MODE PRIVATE) 
String text=“ Same data" ; 

fos.write (text.getBytes ()) ; 

fos.flush(); 

fos.close(); 


oO 0 c QM oH 
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代码 首先 定义 新 文件 的 名 称 为 fileDemo. txt, 然 后 使 用 openFileOutput O 函数 以 私 
有 模式 建立 文件 ,并 调用 write() 函数 将 数据 写 和 文件 ,调用 flush() 函 数 将 缓冲 中 的 数据 
写 人 文件 ,最 后 调用 closeO 函数 关闭 FileOutputStream。 

为 了 提高 文件 系统 的 性 能 ,一 般 调用 write O 函数 时 ,如 果 写 人 的 数据 量 较 小 ,系统 
会 把 数据 保存 在 数据 缓冲 区 中 ,等 数据 量 积 攒 到 一 定 程度 时 青 将 数据 一 次 性 写 入 文件 。 
因此 ,在 调用 close() 函 数 关闭 文件 前 ,务必 要 调用 flush() 函 数 ,将 缓冲 区 内 所 有 的 数据 
写 人 文件 。 如 果 开 发 人 员 在 调用 close() 函 数 前 没有 调用 flush(), 则 可 能 导致 部 分 数据 

openFileInput O 函数 为 读 取 数 据 做 准备 而 打开 文件 。openFileOutput() 函数 的 语法 
格式 为 : 


public FileInputStream openFileInput (String name) 


第 1 个 参数 也 是 文件 名 称 , 同 样 不 允许 包含 描述 路 径 的 斜 杜 。 使 用 openFileInput() 
函数 打开 已 有 文件 ,并 以 二 进 制 方式 读 取 数 据 的 示例 代码 如 下 。 


String FILE NAME- "fileDeno.txt"; 


FileInputStream fis- cpenFileInput (FIE NAME) ; 


byte[] readBytes- new byte [fis.available()]; 
while (fis.read(readBytes) !- - 1) { 
) 
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上 面 的 两 部 分 代码 在 实际 使 用 过 程 中 会 遇 到 错误 提示 ,这 是 因为 文件 操作 可 能 会 遇 
到 各 种 问题 而 最 终 导 致 操作 失败 ,因此 在 代码 中 应 使 
用 try/catch 捕获 可 能 产生 的 异常 。 | ESL 

InternalFileDemo 示例 用 来 演示 在 内 部 存储 器 
上 进行 文件 写 入 和 读 取 。 用 户 界面 如 图 8. 3 所 示 ， 
用 户 将 需要 写 人 的 数据 添加 在 EditText 中 ,通过 —— 
“ 写 人 文件 ?按钮 将 数据 写 人 到 /data/data/edu. hrbeu fata taat oodata taat 002 
. InternalFileDemo/files/fileDemo. txt 文 件 中 。 如 果 
用 户 选择 “追加 模式 ” ,数据 将 会 添加 到 fileDemo. txt 
文件 的 结尾 处 。 通 过 “ 读 取 文 件 ” 按 钮 ,程序 会 读 取 
fileDemo. txt 文件 的 内 容 ,并 显示 在 界面 下 方 的 白色 
区 域 中 。 

下 面 给 出 InternalFileDemo 示例 的 核心 代码 。 8.3 InternalFileDemo A À RH 


data test 003 
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» OnClickListener writeButtonListener- new OnClickListener() { 
2 GOverride 

E public void onClick(View v) { 

4 FileOutputStream fos- null; 

5 try{ 

6 if (appendBox.isChecked()) ( 

7 fos-cpenFileOutput(FILE NAME,Context.MODE APPEND); 
8 Jeise ( 

9 fos-cpenFileOutput(FILE NBME,Context.MDDE PRIVATE); 
10 } 

nu String text= entryText .getTText () .toString () ; 

12 fos.write (text .getBytes ()) ; 

13 labelView.setText(" 文 件 写 人 成 功 , 写 和 长度 : "text. length 0); 
14 entryText.setText ("") ; 

15 ) catch (FileNotFoundExoeption e) ( 

16 e.printStackTrace () ; 

17 i 

18 catch (IOException e) { 

19 e.printStackTrace () ; 

20 ) 

21 finally( 

22 if(fos!- null)( 

23 try{ 

24 fos.flush(); 

5 fos.close(); 

26 ) catch (IGExoeption e) ( 

27 e.printStackTrace() ; 

28 ) 

29 ) 

30 ) 

3 ) 

2 y 

33  OnClickListener readButtonListener- new OnClickListener() { 
34 GOverride 

35 public void onClick(View v) ( 

36 displayView.setText ("") ; 

3 FileInputStream fis- null; 

38 try{ 

39 fis-gpenFileInput (FILE. NME); 

40 if(fis.available ()- — 0) ( 

Hn retum; 

42 } 

3 byte[] readBytes- new byte[fis.available()]; 
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44 while (fis.read (readBytes) !=- 1) ( 
45 ) 

46 String text- new String (readBytes) ; 
47 displayView.setText (text) ; 

48 labelView.setText ("文件 读 取 成 功 ,文件 长 度 : "+ text. length 0) ; 
49 } catch (FileNotFoundExoeption e) { 

50 e.printStackTrace () ; 

51 } 

52 catch (IOExoeption e) ( 

53 e.printStackTrace|() ; 

Ed ) 

55 k 

56 y 


程序 运行 后 ,在 /data/data/edu. hrbeu. InternalFileDemo/files/ H 3€ F . 3X $] T 3r Æ 
立 的 fileDemo. txt 文件 , 如 图 8. 4 所 示 。 从 文件 权限 上 分 析 fileDemo. txt X ff. 
-rw-rw 一 表明 文件 仅 允许 文件 创建 者 和 同 组 用 户 进 行 读 写 , 其 他 用 户 无 权 使 用 。 文 件 的 
大 小 为 9 个 字 节 ,保存 的 数据 为 Some data. 


4 © edu.hrbeu.InternalFileDemo 2011-10-23 12:45 drwxr-x--x 
4 © files 2011-10-23 12:45 drwxrwx--x 

国 fileDemo.txt 26 2011-10-23 12:45 -rw-rw---- 

b © lib 2011-10-23 12:44 drwxr-xr-x 


8.4 fileDemo. txt 文件 
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Android 的 外 部 存储 设备 一 般 指 Micro SD 卡 ,又 称 工 一 Flash, 是 一 种 广泛 使 用 于 数 
码 设备 的 超 小 型 记忆 卡 , 图 8. 5 是 东芝 出 品 的 32G Micro SD F. 

Micro SD 卡 适 用 于 保存 大 尺 二 的 文件 或 者 是 一 些 无 须 设 置 访 
问 权限 的 文件 。 如 果 用 户 和 希望 保存 录制 的 视频 文件 和 音频 文件 ， 
因为 Android 设备 的 内 部 存储 空间 有 限 ,所 以 使 用 Micro SD EW 
是 非常 适合 的 选择 。 但 如 果 需 要 设置 文件 的 访问 权限 , 则 不 能 够 
使 用 Micro SD 卡 , 因 为 Micro SD 卡 使 用 FAT (File Allocation 
Table) 文 件 系统 ,不 支持 访问 模式 和 权限 控制 。Android 的 内 部 存储 器 使 用 的 是 Linux 
文件 系统 , 则 可 通过 文件 访问 权限 的 控制 保证 文件 的 私密 性 。 

Android 模拟 器 支持 SD 卡 的 模拟 ,在 模拟 器 建立 时 可 以 选择 SD 卡 的 容量 ,如 图 8.6 
所 示 ,在 模拟 器 启动 时 会 自动 加 载 SD 卡 。 正 确 加 载 SD 卡 后 ,SD 卡 中 的 目录 和 文件 被 
映射 到 /mnt/sdcard 目录 下 。 因 为 用 户 可 以 加 载 或 卸载 SD 卡 , 所 以 在 编程 访问 SD 卡 前 
首先 需要 检测 /mnt/sdcard 目录 是 否 可 用 。 如 果 不 可 用 ,说 明 设备 中 的 SD F E A a 
载 。 如 果 可 用 , 则 直接 通过 使 用 标准 的 java. io. File 类 进行 访问 。 


图 8.5 Micro SD 卡 
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SDcardFileDemo 示例 用 来 说 明 如 何 将 数据 保存 在 SD 卡 中 。 首 先 通过 “生成 随机 数 
列 ” 按 钮 生成 10 个 随机 小 数 , 然 后 通过 “ 写 和 人 SD 卡 ” 按 钮 将 生成 的 数据 保存 在 SD 卡 的 根 
目录 下 ,也 就 是 Android 系统 的 /mnt/sdcard 目录 下 。 

SDcardFileDemo 示例 的 用 户 界面 如 图 8.7 所 示 。 


E SDcardFileDemo 


@ Edit Android Virtual Device (AVD) z 
le-13193747558 f S 
Name: AndroidSim4.0 生成 随机 数列 写 入 SD 卡 
Target — [Android 40 - API Level 14 ~ 


CPU/ABE | ARM (armeabi-v7a) 


SD Card: 
@ Size: 128 MiB ~ 
File: ws 
8.6 在 AVD 管 理 器 中 的 模拟 SD E 图 8.7 SDcardFileDemo 用 户 界面 


SDcardFileDemo 示例 运行 后 ,在 每 次 点 击 “ 写 入 SD 卡 ” 按 钮 后 ,都 会 在 SD 卡 中 生产 
-个 新 文件 ,文件 名 各 不 相同 ,如 图 8. 8 所 示 。 


mul-i-"-5 


Name Size Date Time Permissions Info 
© data 2011-10-20 09:39 drwxrwx--x 
4 (E mnt 2011-10-23 12:34 drwxrwxr-x 
© asec 2011-10-23 12:34 drwxr-xr-x 
& obb 2011-10-23 12:34 drwxr-xr-x 
4 © sdcard 2011-10-23 13:00 d---rwxr-x 
© Alarms 2011-10-20 11:30 d---rwxr-x 
& DCIM 2011-10-20 1130 d---rwxr-x 
( Download 2011-10-20 11:30 d---rwxr-x 
& LOST.DIR 2011-10-20 09:40 d---rwxr-x 
© Movies 2011-10-20 11:30 d---rwxr-x 
© Music 2011-10-20 11:30 d---rwxr-x 
( Notifications 2011-10-20 11:30 d---rwxr-x 
© Pictures 2011-10-20 1130 d---rwxr-x 
(& Podcasts 2011-10-20 11:30 d---rwxr-x 
& Ringtones 2011-10-20 11:30 d---rwxr-x 
SdcardFile-1319374755819.t«t 194 2011-10-23 12:59 ----rwxr-x 
Bj SdcardFile-1319374808394.t« 194 2011-10-23 13:00 ----rwxr-x 
Bj SdcardFile-1319374809968. 192 2011-10-23 13:00 --—rwxr-x 
© secure 2011-10-23 12:34 drwx------ 
© system 2011-10-12 19:45 drwxr-xr-x 
af m , 


图 8.8 SD 卡 中 生成 的 文件 


SDcardFileDemo 示例 与 InternalFileDemo 示例 的 核心 代码 比较 相似 ,不 同 之 处 在 于 
代码 中 添加 了 /mnt/sdcard 目录 存在 性 检查 (代码 第 7 行 ), 并 使 用 “绝对 目录 十 文件 名 ” 
的 形式 表示 新 建立 的 文件 (代码 第 8 行 ) ,并 在 写 入 文件 前 对 文件 的 存在 性 和 可 写 和 人 性 进 
行 检查 (代码 第 12 行 )。 为 了 保证 在 SD 卡 中 多 次 写 人 时 文件 名 不 会 重复 ,在 文件 名 中 使 
用 了 唯一 且 不 重复 的 标识 (代码 第 5 行 ), 这 个 标识 通过 调用 System. currentTimeMillis O FR 


数 获得 ,表示 从 1970 年 00:00:00 到 当前 所 经 过 的 毫秒 数 。SDcardFileDemo 示例 的 核心 


代码 如 下 。 
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private static String randamNumbersString- ""; 
OnClickListener writeButtonListener- new OnClickListener() { 
GOverride 
public void onClick(View v) ( 
String fileName- "SdcardFile- "+ System.currentTineMi 11 is ()+ " txt"; 
File dir- new File("/sdcard/") ; 
if(dir.exists() && dir.canWrite()) ( 
File newFile- new File (dir.getAbsolutePath ()+ "/"+ fileName) ; 
FileOutputStream fos- null; 
try { 
newFile.createNewFile() ; 
if(newFile.exists() && newFile.canWrite()) ( 
fos- new FileOutputStream(newFile) ; 
fos.write (randamNunbersString.getBytes () ) ; 
TextView labelView- (TextView)findViewById|(R.id.label); 
labelView.setText (£ileName "文件 写 和 人 DF"); 
) 
) catch (IOExoeption e) ( 
e.printStackTrace(); 
) finally ( 
if(fos!- null) ( 
try{ 
fos.flush(); 
fos.close(); 
) 
catch(IOExoeption e) { } 


n 


程序 在 模拟 器 中 运行 前 ,还 必须 在 AndroidManifest. xml 中 注册 两 个 用 户 权 限 ,分 别 
是 加 载 卸 载 文件 系统 的 权限 和 向 外 部 存储 器 写 和 数据 的 权限 。AndroidManifest. xml 的 


核心 代码 如 下 。 


N 


< uses- permission android:name- "android.permission.MOUNT UNMOUNT 

. FILESYSTEMS"» < /uses- permission» 

< uss- permission android:name- "android.permission.WRIIE EXIERNAL SICEACE'- 
« /uses- permission» 
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开发 人 员 除 了 可 以 在 内 部 和 外 部 存储 设备 上 读 写 文件 以 外 ,还 可 以 访问 在 /res/raw 
和 /res/xml 目录 中 的 原始 格式 文件 和 XML 文件 ,这 些 文件 是 程序 开发 阶段 在 工程 中 保 
存 的 文件 。 

原始 格式 文件 可 以 是 任何 格式 的 文件 ,例如 视频 格式 文件 .音频 格式 文件 .图 像 文件 
或 数据 文件 等 。 在 应 用 程序 编译 和 打包 时 ,/res/raw 目录 下 的 所 有 文件 都 会 保留 原 有 格 
式 不 变 。 而 /res/xml 目录 下 一 般 用 来 保存 格式 化 数据 的 XML 文件 ,会 在 编译 和 打包 时 
将 XML 文件 转换 为 二 进 制 格 式 , 用 以 降低 存储 器 空间 占用 和 提高 访问 效率 ,在 应 用 程序 
运行 的 时 候 会 以 特殊 的 方式 进行 访问 。 

ResourceFileDemo 示例 演示 了 如 何在 程序 运行 时 访问 资源 文件 。 当 用 户 点 击 “ 读 取 
原始 文件 ”按钮 时 ,程序 将 读 取 /res/raw/raw_file. txt 文件 ,并 将 内 容 显示 在 界面 上 ,如 
图 8.9(a) 所 示 。 当 用 户 点 击 * 读 取 XML 文件 ”按钮 时 ,程序 将 读 取 /res/xml/people. xml 
文件 ,也 将 内 容 显示 在 界面 上 ,如 图 8. 9(b) 所 示 。 


J * 
[a ResourceFileDemo | a ResourceFileDemo 


1 


读 取 原 始 文 ” 读 取 XML 文 ”清除 显 读 取 原 始 文 — 读 取 XML 文 AE 
件 件 示 件 件 示 


(a) 读 取 原 始 文件 (b) 读 取 XML 文 件 
8.9 ResourceFileDemo 用 户 界面 


读 取 原始 格式 文件 首先 需要 调用 getResource O 函数 获得 资源 实例 ,然后 通过 调用 
资源 实例 的 openRawResource() 函 数 ,以 二 进 制 流 的 形式 打开 指定 的 原始 格式 文件 。 在 
读 取 文件 结束 后 ,调用 close() 函 数 关闭 文件 流 。 

ResourceFileDemo 示例 中 读 取 原始 格式 文件 的 核心 代码 如 下 。 


Resources resources= this.getResources () 7 
InputStream inputStream- null; 
uyt 
inputStream- rescuroes.gpenRawResource (R.raw.raw file); 
byte[] reader- new byte [inputStream.avai lable () ] ; 
while (inputStream.read(reader)!-- 1) ( 
) 
displayView.setText (new String (reader, "utf- 8")); 
} catch (IOException e) ( 
10 Log.e ("ResourceFileDemo", e.getMessage (), €); 
1 }finllyt{ 


QO 0 - O UO QU I ^ 
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12 if(nputStream!- null) ( 
13 tyi 

14 inputStream.close () ; 
15 } 

16 catch (ICException e) () 

17 ) 

18 } 


代码 第 8 行 的 new String(reader, "utf-8") ,表示 以 UTF-8 的 编码 方式 从 字 节 数组 
中 实例 化 一 个 字符 串 。 如 果 程 序 开发 人 员 需 要 新 建 /res/raw/raw_file. txt 文件 , 则 需要 
选择 使 用 UTF-8 编码 方式 ,和 否则 程序 运行 时 会 产生 乱码 。 选 择 的 方法 是 在 raw_file. txt 
文件 上 右 击 ,选择 Properties 以 打开 raw. file. txt 文件 的 属性 设置 框 , 然 后 在 Resource 栏 
下 的 Text file encoding 中 ,选择 Other; 和 UTF-8 ,如 图 8. 10 所 示 。 


[bpe itor tet | | Resource. erore 
Besowos| Path: /ResourcefileDemo/res/raw/raw filet. 
Run/Debug Settings ue ires 

Location:  GMAndroid\workplace\ResourcefileDemo\res\raw\raw fle txt. 

Size: 92 bytes 

Last modified: 2011 年 10 月 23 日 下 午 9:04:02 

Attributes: 

Read only 

I] Archive. 

E Derived 

Text file encoding 


© Default (inherited from container: GBQ 


eon HS -| 


由 


@ [| 


图 8.10 选择 raw_file. txt 文件 编码 方式 


/res/xml 目录 下 的 XML 文件 与 其 他 资源 文件 有 所 不 同 ,程序 开发 人 员 不 能 够 以 流 
的 方式 直接 读 取 , 其 主要 原因 在 于 Android 系统 为 了 提高 读 取 效率 ,减少 占用 的 存储 空 
间 ,将 XML 文件 转换 为 一 种 高 效 的 二 进 制 格式 。 

为 了 说 明 如 何在 程序 运行 时 读 取 /res/xml 目录 下 的 XML 文件 ,首先 在 /res/xml H 
录 下 创建 一 个 名 为 people. xml 的 文件 。XML 文件 定义 了 多 个 二 person 过 元素, 每 个 
<person> TREA =A JAE name age 和 height, 分 别 表 示 姓 名 、 年 龄 和 身高 。 

/res/ xml/people. xml 文件 代码 如 下 。 


1  «pegle 
2 < person name= " 李 某 某 " age- "21" height= "1.81"/» 
3 « person name= " 王 某 某 " age- "25" height= "1.76"/» 
4 < person name= "jk 5E 5. " age- "20" height= "1.69"/» 
5 </p> 
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读 取 XML 格式 文件 ,首先 通过 调用 资源 实例 的 getXml() 函 数 , 获 取 到 XML 解析 器 
XmlPullParser。XmlPullParser 是 Android 平台 标准 的 XML 解析 器 ,这 项 技术 来 自 一 
个 开源 的 XML 解析 API 项 目 XMLPULL。 

ResourceFileDemo 示例 中 关于 读 取 XML 文件 的 核心 代码 如 下 。 


1 XmlPullParser parser- resources .get?iml (R.xml .people) ; 
2 String msg- ""; 
3 uyt 
4 while (parser.next () != Xm! PullParser.END DOCUMENT) ( 
5 String people- parser.getNane () ; 
6 String name- null; 
4 String age= null; 
8 String height= null; 
9 if((people!- null) && people.equals ("person")) { 
10 int count- parser.getAttributeCount () ; 
1l for(int i-0; i« count; i++) ( 
12 String attrName- parser.getAttributeName (i) ; 
13 String attrValue- parser.getAttributeValue (i) ; 
14 if((attrName!- null) && attrName.equals ("name")) ( 
15 name- attrValue; 
16 ) else if((attrName!- null) && attrName.equals ("age")) ( 
17 age- attrValue; 
18 Jelse if ((attiName!- null) && attrName.equals ("height") ) ( 
19 height- attrValue; 
20 ) 
pu ) 
22 if((name!'-null) &&(age!- null) &&(height!- null)) ( 
msgt - "lE 44 : "+namet "AE RE : "+ ager ", 身 高 : "+ height "Nn" 
24 ) 
25 ) 
26 } 
27 | catch (Exception e) { 
28 Iog.e ("FesourceFileDemo", e.getMessage (), e); 
29 ] 
30  displayiew.setText (msg) ; 


代码 第 1 行 通过 资源 实例 的 getXml O 函数 获取 到 XML 解析 器 。 第 4 行 的 parser 
. next() 方 法 可 以 获取 到 高 等 级 的 解析 事件 ,并 通过 对 比 确定 事件 类 型 ,XML 事件 类 型 
参考 表 8. 2。 

第 5 行使 用 getrName() 函 数 获 得 元 素 的 名 称 ,第 10 行使 用 getAttributeCount O FR 
数 获取 元 素 的 属性 数量 ,第 12 行 通过 getAttributeName O 函数 得 到 属性 名 称 。 最 后 在 
第 14 行 到 第 19 行 代码 中 ,通过 分 析 属 性 名 获取 到 正确 的 属性 值 , 并 在 第 23 行将 属性 值 
整理 成 需要 显示 的 信息 。 
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表 8.2 XmlPullParser 的 XML 事件 类 型 


事件 类 型 Wü oH 事件 类 型 说 有明 
START_TAG 读 取 到 标签 开始 标志 END TAG 读 取 到 标签 结束 标志 
TEXT 读 取 文本 内 容 END DOCUMENT | 文档 末尾 
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数据 库存 储 是 Android 数据 存储 中 非常 重要 的 内 容 。Android 系统 提供 一 个 轻 量 级 
的 戏 入 式 关系 数据 库 SQLite, 本 节 将 详细 介绍 如 何 通 过 代码 和 命令 行 方式 建立 数据 库 ， 
并 实现 添加 、 删 除 、 查 找 和 更 新 等 基本 的 数据 操作 。 
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SQLite 是 一 个 2000 年 由 D. Richard Hipp 发 布 的 开源 嵌入 式 关 系数 据 库 。 自 从 出 
现 商 业 应 用 程序 以 来 ,数据 库 就 一 直 是 应 用 程序 的 主要 组 成 部 分 ,数据 库 的 管理 系统 也 
比较 庞大 和 复杂 , 且 会 占用 较 多 的 系统 资源 。 随 着 嵌入 式 应 用 程序 的 大 量 出 现 ,一 种 新 
型 的 轻 量 级 数据 库 SQLite 也 随 之 产生 。SQLite 数据 库 比 传统 数据 库 更 适合 用 于 骨 人 式 
系统 ,因为 它 占 用 资源 少 ,运行 高 效 可 靠 ,可 移植 性 强 ,并 且 提 供 了 零 配 置 (zero- 
configuration) 运 行 模式 。 

SQLite 数据 库 的 优势 在 于 其 可 以 嵌入 到 使 用 它 的 应 用 程序 中 。 这 样 不 仅 提高 了 运 
行 效率 ,而 且 屏蔽 了 数据 库 使 用 和 管理 的 复杂 性 ,应 用 程序 仅 做 最 基本 的 数据 操作 ,其 他 
操作 则 交 给 进程 内 部 的 数据 库 引 擎 完成 。 同 时 ,因为 客户 端 和 服务 器 在 同一 进程 空间 运 
行 ,所 以 完全 不 需要 进行 网 络 配置 和 管理 ,减少 了 网 络 调用 所 造成 的 额外 开销 。 这 样 的 
方式 简化 了 数据 库 的 管理 过 程 , 使 应 用 程序 更 加 易于 部 署 和 使 用 ,程序 开发 人 员 仅 需要 
把 SQLite 数据 库 正 确 编 译 到 应 用 程序 中 即 可 。 

SQLite 数据 库 采 用 了 模块 化 设计 ,模块 将 复杂 的 查询 过 程 分 解 为 细小 的 工作 进行 处 
理 。SQLite 数据 库 由 8 个 独立 的 模块 构成 ,这 些 独立 模块 又 构成 了 三 个 主要 子 系统 。 
SQLite 数据 库 体系 结构 如 图 8. 11 所 示 。 

接口 由 SQLite C API 组 成 ,因此 无 论 是 应 用 程序 .脚本 ,还 是 库 文件 ,最终 都 是 通过 
接口 与 SQLite 交互 。 

在 编译 器 中 ,分 词 器 和 解析 器 对 SQL 语句 进行 语法 检查 ,然后 把 SQL 语句 转化 为 便 
于 底层 处 理 的 分 层 数据 结构 ,这 种 分 层 的 数据 结构 称 为 “语法 树 ”。 然 后 把 语法 树 传 给 代 
码 生 成 器 进行 处 理 , 生 成 一 种 用 于 SQLite 的 汇编 代码 ,最 后 由 虚拟 机 执行 。 

SQLite 数据 库 体 系 结构 中 最 核心 的 部 分 是 虚拟 机 ,也 称 为 虚拟 数据 库 引擎 (Virtual 
Database Engine. VDBE) 。 与 Java 虚拟 机 相似 ,虚拟 数据 库 引 擎 用 来 解释 并 执行 字 节 代 
码 。 虚 拟 数据 库 引 擎 的 字 节 代码 由 128 个 操作 码 构 成 ,这 些 操作 码 主要 用 以 对 数据 库 进 
行 操作 ,每 一 条 指令 都 可 以 完成 特定 的 数据 库 操作 ,或 以 特定 的 方式 处 理 栈 的 内 容 。 
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接口 - B 树 
1 1 
编译 器 分 词 器 dd Ehi 

1 

解析 器 操作 系统 接口 
1 

代码 生成 器 C 2 

1 数据 库 

虚拟 机 


8.11 SQLite 数据 库 体 系 结构 


后 端 由 B 树 、 页 缓存 和 操作 系统 接口 构成 ,B 树 和 页 缓存 共同 对 数据 进行 管理 。B 树 
的 主要 功能 就 是 索引 , 它 维护 着 各 个 页 面 之 间 的 复杂 关系 ,便于 快速 找到 所 需 数据 。 页 
缓存 的 主要 作用 是 通过 操作 系统 接口 在 B 树 和 磁盘 之 间 传 递 页 面 。 

SQLite 数据 库 具有 很 强 的 移植 性 ,可 以 运行 在 Windows、Linux、BSD、Mac OS 和 一 
些 商 用 Unix 系统 ,比如 Sun 的 Solaris 或 IBM 的 AIX。 同 样 , 也 可 以 工作 在 许多 敌人 式 
操作 系统 下 ,比如 QNX, VxWorks, Palm OS,Symbin 和 Windows CE, SQLite 的 核心 大 
约 有 3 万 行 标准 C 代码, 因为 模块 化 的 设计 使 这 些 代码 非常 易于 理解 。 
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在 Android 系统 中 ,每 个 应 用 程序 的 SQLite 数据 库 被 保存 在 各 自 的 /data/data/ 
二 package nameZ7/databases 目录 下 。 默 认 情 况 下 ,所 有 数据 库 都 是 私有 的 , 仅 允 许 创 建 
数据 库 的 应 用 程序 访问 ,如 果 需 要 共享 数据 库 , 则 可 以 使 用 ContentProvider。 虽 然 应 用 
程序 完全 可 以 在 代码 中 动态 建立 SQLite 数据 库 , 但 使 用 命令 行 手 工 建 立 和 管理 数据 库 
仍然 是 非常 重要 的 内 容 , 对 于 调试 使 用 数据 库 的 应 用 程序 非常 有 用 。 

手动 建立 数据 库 指 的 是 使 用 sqlite3 工具 ,通过 手工 输入 命令 行 完成 数据 库 的 建立 过 
程 。sqlite3 是 SQLite 数据 库 自 带 的 一 个 基于 命令 行 的 SQL 命令 执行 工具 ,并 可 以 显示 
命令 执行 结果 。Android SDK 的 tools 目录 有 sqlite3 工具 ,同时 ,该 工具 也 被 集成 在 
Android 系统 中 。 

下 面 的 内 容 将 介绍 如 何 连 接 到 模拟 器 中 的 Linux 系统 ,并 在 Linux 系统 中 启动 
sqlite3 工具 ,在 Android 程序 目录 中 建立 数据 库 和 数据 表 , 并 使 用 命令 在 数据 表 中 添加 、 
修改 和 删除 数据 。 

开发 人 员 可 以 使 用 adb shell 命令 连接 到 模拟 器 的 Linux 系统 ,在 Linux 命令 提示 符 
下 输入 sqlite3 可 启动 sqlite3 工具 。 启 动 sqlite3 后 会 显示 SQLite 的 版 本 信息 ,显示 内 容 
如 下 所 示 。 
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3 
4 
5 


Enter ".help" for instructions 
Enter SQL statements terminated with a ";" 
sqlite 


在 启动 sqlite3 工具 后 HERI HREH sqlite> , zs Hl PHEA SQLite 数据 库 交互 
模式 ,此 时 可 以 输入 命令 建立 \ 删 除 或 修改 数据 库 的 内 容 。 正 确 退 出 sqlite3 工具 的 方法 
是 使 用 . exit 命令 。 


1 
2 


sqlite> .exit 
* 


原则 上 ,每 个 应 用 程序 的 数据 库 都 保存 在 各 自 的 /data/data/ 二 package name > 
/databases 目录 下 ,但 如 果 使 用 手工 方式 建立 数据 库 , 则 必须 手工 建立 数据 库 目 录 , 目 前 


版 本 无 须 修改 数据 库 目 录 的 权限 。 
1 #mkdir databases 
2 #1s -1 
3 drwxrwxrwx root root 2011- 09- 19 15:43 databases 
4 drwxr- xr- x system system 2011- 09- 19 15:31 lib 
5 + 


在 SQLite 数据 库 中 ,每 个 数据 库 保存 在 一 个 独立 的 文件 中 。 使 用 “sqlite3 十 文件 名 ”的 
方式 打开 数据 库 文件 ,如 果 指 定 的 文件 不 存在 ,sqlite3 工具 则 自动 创建 新 文件 。 下 面 的 代码 
将 创建 名 为 people 的 数据 库 , 在 文件 系统 中 将 产生 一 个 名 为 people. db 的 数据 库 文 件 。 


o 0 - 0 


10 


# sqlite3 People.db 
SQLite version 3.6.22 

Enter ".help" for instructions 

Enter SQL statements terminated with a ";" 
sqlite 


下 面 的 代码 在 数据 库 中 ,使 用 create table 命令 构造 了 一 个 名 为 peopleinfo 的 表 , 关 
系 模式 为 peopleinfo(_id, name，age，height)。 表 包含 4 个 属性 :_id 是 整 型 的 主键 ; 
name 表示 姓名 ,字符 型 ,not null 表示 属性 值 一 定 要 填写 .不 可 以 为 空 值 ;age 表示 年 龄 ， 
整数 型 ;height 表示 身高 , 浮 点 型 。 


1: 
2 
3 
4 
5 
6 


Sqlite» create table peopleinfo 

.> ( id integer primary key autoincrement, 
.… > name text not null, 

-.»age integer, 

..»height float); 

sqlite> 
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为 了 确认 数据 表 是 否 创建 成 功 ,可 以 使 用 . tables 命令 ,显示 当前 数据 库 中 的 所 有 表 。 
从 下 面 的 代码 中 可 以 观察 到 ,当前 的 数据 库 中 仅 有 一 个 名 为 peopleinfo 的 表 。 


sqlite> .tables 
2 poepleinfo 
3 sqlite» 


当然 ,也 可 以 使 用 . schema 命令 查看 建立 表 时 使 用 的 SQL 命令 。 如 果 当 前 数据 库 中 
包含 多 个 表 , 则 可 以 使 用 “. schema 表 名 ”的 形式 ,显示 指定 表 的 建立 命令 。 


sqlite> .schema 

CREATE. TABIE pecpleinfo 

C id integer primary key autoincrement, 
name text not null, 

age integer, 

height float); 

sqlite 
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下 一 步 是 向 peopleinfo 表 中 添加 数据 ,使 用 insert into * values 命令 。 在 下 面 的 代 
码 成 功 运行 后 ,数据 库 的 peopleinfo 表 将 有 三 条 数据 ,内 容 如 表 8. 3 所 示 。 因 为 _id 是 自 
动 增加 的 主键 ,因此 在 输入 null 后 ,SQLite 数据 库 会 自动 填写 该 项 的 内 容 。 


1 sqlite> insert into Peopleinfo values (null, 'Tam',21,1.81); 
2 sqlite> insert into peopleinfo values (null, 'Jim',22,1.78) ; 
3 sqlite> insert into peopleinfo values (null, 'Lily',19,1.68); 


表 8.3  peopleinfo 3& P3 


_id name age height 
Tom 21 1.81 
2 Jim 22 1:78 
3 Lily 19 1.68 


在 数据 添加 完毕 后 ,使 用 select 命令 ,显示 peopleinfo 数据 表 中 的 所 有 数据 信息 ， 
命令 格式 为 “select 属性 from 表 名 ”。 下 面 的 代码 用 来 显示 peopleinfo 表 的 所 有 
数据 。 


1  select* fran pecpleinfoy 
2 — 1|Toi21I1.81 

3  2|Jim|22]1.78 

4 — 3lLilyl1911.68 

5 


sqlite 
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上 面 的 查询 结果 看 起 来 不 是 很 直观 ,使 用 表格 方式 显示 更 符合 习惯 ,因此 可 以 使 用 
. mode 命令 更 改 结 果 输 出 格式 。. mode 命令 除了 支持 常见 的 column 格式 外 ,还 支持 csv 
格式 html 格式 insert 格式 、line 格式 list 格式 、tabs 格式 和 tcl 格式 。 下 面 使 用 column 
格式 显示 peopleinfo 数据 表 中 的 数据 信息 。 


1 sqlite .mde colum 

2 sqlite select * frm peopleinfo; 

3 1 Tan 21 1.81 
4 2 Jim 22 1.78 
5 3 lily 19 1.68 
6 sqlite 


更 新 数据 可 以 使 用 update 命令 ,命令 格式 为 : 


update 表 名 set 属性 = "新 值 " where 条 件 


更 新 数据 后 ,同样 使 用 select 命令 显示 数据 ,确定 数据 是 否 正确 更 新 。 下 面 的 代码 将 
Lily 的 身高 更 新 为 1. 88. 


1 sqlitey update pecpleinfo set height= 1.69 where name= "Lily"; 
2 sqlite select * fran pecpleinfo; 

3  select* fran pecpleinfo; 

4 1 Tam 2 1.81 

5 2 Jim 22 1.78 

6 3 lily 19 1.88 

7 site 


删除 数据 可 以 使 用 delete 命令 ,命令 格式 为 “delete from KA where 条 件 ”。 下 面 的 
代码 将 _id 为 3 的 数据 从 表 peopleinfo 中 删除 。 


1  sqlite» delete fram peopleinfo where id-3; 
2 sqlite select * fram peopleinfo; 

3 select * fram peopleinfo; 

4 1 Tan 21 1.81 

5 2 Jim 2 1.78 

6 sqlite 


sqlite3 工具 还 支持 很 多 命令 ,可 以 使 用 . help 命令 查询 sqlite3 的 命令 列表 ,也 可 以 参 
考 表 8.4, 这 里 就 不 再 详细 介绍 了 。 
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表 8.4 sqlite3 命令 列表 


编 号 命 4 说 上 明 
1 . bail ON|OFF 遇 到 错误 是 停止 ,默认 为 OFF 
2 . databases 显示 数据 库 名 称 和 文件 位 置 
3 . dump? TABLE?... 将 数据 库 以 SQL 文本 形式 导出 
4 . echo ON| OFF 开启 和 关闭 回 显 
5 .exit 退出 
„explain ONIOFF 开启 或 关闭 适当 输出 模式 ,如 果 开启 模式 将 更 改 为 

column, 并 自动 设置 宽度 
7 . header(s) ON| OFF 开启 或 关闭 标题 显示 
8 . help 显示 帮助 信息 
9 .import FILE TABLE 将 数据 从 文件 导入 表 
10 .indices TABLE 显示 表 中 的 列 名 
11 .load FILE? ENTRY? 导入 扩展 库 
12 . mode MODE? TABLE? 设置 输入 格式 
13 .nullvalue STRING 打印 时 使 用 STRING 代替 NULL 
14 .output FILENAME 将 输入 保存 到 文件 
15 .output stdout 将 输入 显示 在 屏幕 上 
16 . prompt MAIN CONTINUE 替换 标准 提示 符 
17 . quit 退出 
18 .read FILENAME 在 文件 中 执行 SQL 语句 
19 .schema? TABLE? 显示 表 的 创建 语句 
20 .separator STRING 更 改 输入 和 导入 的 分 隔 符 
21 . show 显示 当前 设置 变量 值 
22 .tables? PATTERN? 显示 符合 匹配 模式 的 表 名 
23 . timeout MS 尝试 打开 被 锁定 的 表 MS 毫秒 
24 . timer ON|OFF 开启 或 关闭 CPU 计时 器 
25 . width NUM NUM ... 设置 column 模式 的 宽度 
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在 代码 中 动态 建立 数据 库 是 比较 常用 的 方法 。 例 如 在 程序 运行 过 程 中 , 当 需 要 进行 
数据 库 操作 时 ,应 用 程序 会 首先 尝试 打开 数据 库 , 此 时 如 果 数 据 库 并 不 存在 ,程序 则 会 自 
动 建立 数据 库 , 然 后 再 打开 数据 库 。 
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在 编程 实现 时 ,一 般 将 所 有 对 数据 库 的 操作 都 封装 在 一 个 类 中 ,因此 只 要 调用 这 个 


类 ,就 可 以 完成 对 数据 库 的 添加 、 更 新 、 删 除 和 查询 等 操作 。 下 面 内 容 是 DBAdapter 类 的 


部 分 代码 ,封装 了 数据 库 的 建立 、 打 开 和 关闭 等 操作 。 


1 public class DBdapter { 

2 private static final String DB. NAME- "people.db"; 
3 private static final String DB. TAHLE- "peopleinfo"; 
4 private static final int DB VERSION- 1; 

5 

6 public static final String KEY ID-" id"; 

7 public static final String KEY NAME= "name"; 

8 public static final String KEY AGE- "age"; 

9 public static final String KEY HEIGHT- "height"; 
10 

1l private SQLiteDatabase db; 

12 private final Context context; 

13 private DBopenBelper dbOpenHelper; 

14 

15 private static class DBOpenHelper extends SQLiteOpenHelper {} 
16 

17 public DBRGapter (Context_context) ( 

18 context- context; 

19 ] 

20 

a public void open() throws SQLiteException { 

2 dbOpenHelper- new IBOpenHelper (context, IB NAME, null, DB VERSION); 
23 try { 

24 do- dbopenHelper.getWritableDatabase () ; 
25 }catch (SüLiteExoeption ex) ( 

26 do- doopentelper.getReadableDatabase () ; 
27 ] 

28 ) 

29 

30 public void close() { 

31 if(do!'-null)( 

mz db.close(); 

33 do-null; 

3 ) 

35 } 

36 ] 


从 代码 的 第 2 行 到 第 9 行 可 以 看 出 ,在 DBAdapter 类 中 首先 声明 了 数据 库 的 基本 信 
息 , 包 括 数据 库 的 文件 名 称 、 表 名 称 和 版 本 号 ,以 及 数据 库 表 的 属性 名 称 。 从 这 些 基 本 信 


202 LAST 


息 上 不 难 发 现 ,这 个 数据 库 与 8. 3. 2 节 手 动 建立 的 数据 库 是 完全 相同 的 。 

代码 第 11 行 声 明了 SQLiteDatabase 的 实例 。SQLiteDatabase 类 封装 了 较 多 的 方 
法 ,用 以 建立 ,删除 数据 库 ,执行 SQL 命令 ,对 数据 进行 管理 等 工作 。 

代码 第 13 行 声 明了 一 个 非常 重要 的 帮助 类 SQLiteOpenHelper, 这 个 帮助 类 可 以 辅 
助 建立 .更 新 和 打开 数据 库 。 虽 然 在 代码 第 21 行 定义 了 open() 函 数 用 来 打开 数据 库 ,但 
open O 函数 中 并 没有 任何 对 数据 库 进行 实际 操作 的 代码 ,而 是 调用 了 SQLiteOpen- 
Helper 类 的 getWritableDatabase() 函数 和 getReadableDatabase O 函数 。 这 两 个 函数 会 
根据 数据 库 是 否 存 在 、 版 本 号 和 是 否 可 写 等 情况 ,决定 在 返回 数据 库 实例 前 ,是 否 需 要 建 
立 数 据 库 。 

在 代码 第 30 行 的 close() 函 数 中 ,调用 了 SQLiteDatabase 实例 的 close() 方 法 关闭 数据 
库 。 这 是 代码 中 唯一 一 处 直接 调用 了 SQLiteDatabase 实例 的 方法 。SQLiteDatabase 中 也 封 
装 了 打开 数据 库 的 函数 openDatabases() 和 创建 数据 库 函 数 openOrCreateDatabases O ,因为 
代码 中 使 用 了 帮助 类 SQLiteOpenHelper, 从 而 避免 直接 调用 SQLiteDatabase 的 打开 和 创建 
数据 库 的 方法 ,简化 了 数据 库 打 开 过 程 中 繁琐 的 逻辑 判断 过 程 。 

DBOpenHelper 继承 了 帮助 类 SQLiteOpenHelper, 重 载 了 onCreate() 函数 和 onUp- 
gradeO PRACT An F 


1 private static class TBOpenHelper extends SQLiteOpenHelper ( 

2 public DBOpenHelper (Context context, String name, CursorFactory factory, int version)( 

3 super (context, name, factory, version); 

4 ) 

5 private static final String DB. CFEATE- "create table "+ 

6 IB TABLE- " ("+ KEY_ID+ " integer primary key autoincrement, "+ 

7 KEY NAME+ " text not null, "-KEY AGE*" integer, "+ KEY HEIGHT+ " 
float);"; 

8 

9 GOverride 

10 public void onCreate (SQLiteDatabase do) { 

n . db.execSQL(DB CREATE); 

12 ) 

13 

14 GOverride 

15 pdblic void oatpgrade (SQLiteDatabase db, int oldVersicn, int newWersicn) ( 

16 . db.execSQL("TROP TABIE IF EXISTS "+ DB TABIE) ; 

v oncreate( do); 

18 ] 

19 ] 


代码 的 第 5 行 到 第 7 行 是 创建 表 的 SQL 命令 。 代 码 第 10 行 和 第 15 行 分 别 重 载 了 
onCreate() 函数 和 onUpgrade O PR Zt. 3x Je AK JK& SQLiteOpenHelper 类 必须 重 载 的 两 个 
函数 。onCreate() 函数 在 数据 库 第 一 次 建立 时 被 调用 ,一 般 用 来 创建 数据 库 中 的 表 , 并 完 
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成 初始 化 工作 。 在 代码 第 11 行 中 ,通过 调用 SQLiteDatabase 实例 的 execSQL() 方 法 , 执 
行 创建 表 的 SQL 命令 。onUpgrade() 函数 在 数据 库 需 要 升级 时 被 调用 ,一 般 用 来 删除 旧 
的 数据 库 表 , 并 将 数据 转移 到 新 版 本 的 数据 库 表 中 。 在 代码 第 16 行 和 第 17 行 中 ,为 了 
简单 起 见 ,并 没有 做 任何 数据 转移 ,而 仅仅 删除 原 有 的 表 后 建立 新 的 数据 表 。 

程序 开发 人 员 不 应 直接 调用 onCreate() 和 onUpgrade O 函数 ,而 应 由 SQLiteOpen- 
Helper 类 来 决定 何 时 调用 这 两 个 函数 。SQLiteOpenHelper 类 的 getWritableDatabase() 函数 
和 getReadableDatabase() 函数 是 可 以 直接 调用 的 函数 。getWritableDatabase() 函数 用 来 建 
立 或 打开 可 读 写 的 数据 库 实 例 , 一 旦 函数 调用 成 功 ,数据 库 实 例 将 被 缓存 ,在 需要 使 用 数据 
库 实例 时 就 可 以 调用 这 个 方法 获取 数据 库 实例 ,务必 在 不 使 用 时 调用 close O 函数 关闭 数据 
库 。 如 果 保 存 数据 库 文件 的 磁盘 空间 已 满 ,调用 getWritableDatabase O 函数 则 无 法 获得 可 
读 写 的 数据 库 实例 ,这 时 可 以 调用 getReadableDatabase O 函数 ,获得 一 个 只 读 的 数据 库 
实例 。 

当然 ,如 果 程 序 开 发 人 员 不 希望 使 用 SQLiteOpenHelper 类 ,也 可 以 直接 使 用 SQL 
命令 建立 数据 库 。 首 先 调用 openOrCreateDatabases O 函数 创建 数据 库 实例 ,然后 调用 
execSQL() 函数 执行 SQL 命令 ,完成 数据 库 和 数据 表 的 建立 过 程 ,其 示例 代码 如 下 。 


1 private static final String DB. CREATE- "create table "+ 
2 DB TABIEt "("- KEY IDt" integer primary key autoincrement, "+ 

3 KEY NAME+ " text not null, "+ KEY AGEt" integer,"* KEY HEIGHT* " float);"; 
4 public void create() ( 

5 do.cpenOrCreateDatabases (DB NAME, context.MODE PRIVATE, null) 

6 db.execSQL(TB CREATE); 

1 


834 数据 操作 


数据 操作 指 的 是 对 数据 的 添加 、 删 除 .查找 和 更 新 操作 ,虽然 程序 开发 人 员 完 全 可 以 
通过 执行 SQL 命令 名 完成 数据 操作 ,但 这 里 仍然 推荐 使 用 Android 提供 的 专用 类 和 方 
法 ,这 些 类 和 方法 的 使 用 更 加 简洁 方便 。 

为 了 使 DBAdapter 类 支持 数据 添加 、 删 除 、 更 新 和 查找 等 功能 ,在 DBAdapter 类 中 
增加 下 面 的 函数 。 其 中 ,insert(People people) 用 来 添加 一 条 数据 ,queryAllData() 用 来 
获取 全 部 数据 ,queryOneData(long id) 根 据 id 获取 一 条 数据 ,deleteAllData() 用 来 删除 
全 部 数据 , deleteOneData (long id) 根据 id 删除 一 条 数据 ,updateOneData (long id. 
People people) 根 据 id 更 新 一 条 数据 。 


public class DBAdapter { 
public long insert (People people) {} 
public long deleteAllData () () 
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4 public long deleteOneData (long id) {} 

5 public People[]queryAl Data () {} 

6 public People[]gueryoneData (long id) () 

7 public long updateOneData (long id, People people) {} 
8 

9 private People []ConvertToPeople (Cursor cursor) {} 
10 H 


ConvertToPeople( Cursor cursor) 是 私有 函数 ,作用 是 将 查询 结果 转换 为 自 定义 的 
People 类 实例 。People 类 包含 4 个 公共 属性 ,分别 为 ID, Name, Age 和 Height, 对 应 数 
据 库 中 的 4 个 属性 值 。 重 载 toString() 函数 ,主要 是 便于 界面 显示 的 需要 。 


People 类 的 代码 如 下 。 
1 public class Pecple ( 
2 public int ID- - 1; 
3 public String Name; 
4 public int Age; 
5 public float Height; 
6 
7 GOverride 
8 public String toString() { 
9 String result- ""; 
10 result - "ID: "+ this.IDt ","; 
1 Tesult+= "姓名 : "+this.Namet ","; 
12 result+= "年 龄 : 叶 this.Mger ", "; 
13 resultt- "E fj : "+ this.Height* ","; 
14 return result; 
15 } 
16 } 


SQLiteDatabase 类 的 公有 函数 insert()、delete()、update() 和 query O ,封装 了 执行 
添加 、 删 除 . 更 新 和 查询 功能 的 SQL 命令 。 下 面 分 别 介绍 如 何 使 用 SQLiteDatabase 类 的 
公有 函数 ,完成 数据 的 添加 删除 .更 新 和 查询 等 操作 。 


1. 添加 功能 


为 了 添加 一 条 新 数据 ,首先 构造 一 个 ContentValues 实例 ,然后 调用 ContentValues 
实例 的 put() 方 法 ,将 每 个 属性 的 值 写 人 到 ContentValues 实例 中 ,最 后 使 用 SQLite- 
Database 实例 的 insert O ER Zt. f£. ContentValues 实例 中 的 数据 写 入 到 指定 的 数据 表 中 。 
insert O 函数 的 返回 值 是 新 数据 插入 的 位 置 . 即 ID 值 。ContentValues 类 是 一 个 数据 承 
载 容器 ,主要 用 来 向 数据 库 表 中 添加 一 条 数据 。 
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public long insert (People people) { 
ContentValues newValues- new ContentValues () ; 


newValues.put(KEY NAME, people.Name); 
new/alues.put(KEY AGE, people.Age); 
newValues.put(KEY HEIGHT, pecple.Height); 


retum db.insert (DB TABIE, null, newalues); 
) 


oo 0 0 UNBE 


第 4 行 代 码 向 ContentValues 实例 newValues 中 添加 一 个 名 称 / 值 对 ,put() 函数 的 
第 1 个 参数 是 名 称 ,第 2 个 参数 是 值 。 第 8 行 代码 的 insert() 函数 中 ,第 1 个 参数 是 数据 
表 的 名 称 ;第 2 个 参数 是 替换 数据 , 当 第 3 个 参数 中 的 数据 为 空 时 使 用 ;第 3 个 参数 是 需 
要 向 数据 库 表 中 添加 的 数据 。 


2. 删除 功能 


删除 数据 比较 简单 ,只 需要 调用 当前 数据 库 实 例 的 delete() 函 数 , 并 指明 表 名 称 和 删 
除 条 件 即 可 。 


public long deleteAllData() ( 
retum db.delete(DB TABIE, null, null); 
) 


public long deleteOneData (long id) ( 
retum db.delete(DB TABIE, KEY ID "- "t id, null); 


E 
2 
3 
4 
5 
6 
7 ) 


deleteO 函数 的 第 1 个 参数 是 数据 表 名 称 ,第 2 个 参数 是 删除 条 件 。 在 第 2 行 代码 
中 ,删除 条 件 为 null, 表 示 删 除 表 中 的 所 有 数据 。 代 码 第 6 行 则 指明 要 删除 数据 的 id 值 ， 
因此 deleteOneData O 函数 仅 删除 一 条 数据 ,此 时 delete O 函数 的 返回 值 表 示 被 删除 的 数 
据 数量 。 


3. 更 新 功能 


更 新 数据 同样 要 使 用 ContentValues 实例 ,首先 构造 ContentValues 实例 ,然后 调用 
put() 函数 将 属性 值 写 人 到 ContentValues 实例 中 ,最 后 使 用 SQLiteDatabase 的 update PR 
数 , 并 指定 数据 的 更 新 条 件 。 


1 pblic long updateMmeData(long id, People people) { 

2 ContentValues updateValues- new ContentValues () 7 
3 updateValues.put(KEY NAME, pecple.Name); 

4 updateValues.put(KEY AGE, people.Age); 
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updateValues.put(KEY HEIGHT, pecple.Height); 


retum db.update(DB TABIE, updateValues, KEY ID* ="+ id, null); 


c - o u 


) 


在 代码 的 第 7 行 中 ,update() 函 数 的 第 1 个 参数 表示 数据 表 的 名 称 , 第 2 个 参数 是 更 
新 条 件 。update() 函数 的 返回 值 表示 数据 库 表 中 被 更 新 的 数据 数量 。 


4. 查询 功能 


介绍 查询 功能 前 , 先 要 介绍 一 下 Cursor 类 。 在 Android 系统 中 ,数据库 查询 结果 的 
返回 值 并 不 是 数据 集合 的 完整 拷贝 ,而 是 返回 数据 集 的 指针 ,这 个 指针 就 是 Cursor 类 。 
Cursor 类 支持 在 查询 结果 的 数据 集合 中 以 多 种 方式 移动 ,并 能 够 获取 数据 集合 的 属性 名 
称 和 序号 ,具体 的 方法 和 说 明 可 以 参考 表 8. 5。 


表 8.5 Cursor 类 的 公有 方法 


函 数 说 è 
moveToFirst 将 指针 移动 到 第 一 条 数据 上 
moveToNext 将 指针 移动 到 下 一 条 数据 上 
moveToPrevious 将 指针 移动 到 上 一 条 数据 上 
getCount 获取 集合 的 数据 数量 
getColumnIndexOrThrow 返回 指定 属性 名 称 的 序号 ,如 果 属 性 不 存在 , 则 产生 异常 
getColumnName 返回 指定 序号 的 属性 名 称 
getColumnNames 返回 属性 名 称 的 字符 串 数组 
getColumnIndex 根据 属性 名 称 返回 序号 
moveToPosition 将 指针 移动 到 指定 的 数据 上 
getPosition 返回 当前 指针 的 位 置 


从 Cursor 中 提取 数据 可 以 参考 ConvertToPeople() 函 数 的 实现 方法 。 在 提取 
Cursor 数据 中 的 数据 前 ,推荐 测试 Cursor 中 的 数据 数量 ,避免 在 数据 获取 中 产生 异常 ， 
例如 下 面 代码 的 第 3 行 一 第 5 行 。 从 Cursor 中 提取 数据 使 用 类 型 安全 的 get — Type > O PR 
数 , 函 数 的 参数 是 属性 的 序号 ,为 了 获取 属性 的 序号 ,可 以 使 用 getColumnIndex O 函数 获 
取 指 定 属性 的 序号 。 


private People[] ConvertToPecple (Cursor cursor) { 
int resultCounts- cursor.getCount () ; 

if (resultCounts- = 0|| !cursor.moveToFirst () ) { 
retum null; 


People[] peoples- new People [resultCounts] ; 
for(int i- 0 ; i< resultCounts; i++){ 
peoples[i]- new Pecple() ; 


1 
2 
3 
4 
5 } 
6 
7 
8 
9 peoples [i] .ID= cursor.getInt(0) ; 
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10 Pecples[i] .Name- cursor.getString(cursor.getColumIndex (KEY NAME)); 
1l peoples [i] .Age= cursor.getInt (cursor.getColumIndex(KEY ACE)); 

12 pecples[i] .Eight- cursor.getFloat (cursor.getColumIndex (KEY FEIGHT)) ; 
13 cursor .moveTcoNext () ; 

14 ; 

15 return peoples; 

16 } 


要 进行 数据 查询 就 需要 调用 SQLiteDatabase 类 的 query() 函 数 ,这 个 函数 的 参数 较 


多 ,可 以 参考 表 8.6 的 参数 说 明 ,query() 函 数 的 语法 如 下 。 


Qursor android. database. sqlite. SQLiteDatabase. query (String table, String[] colums，String selection, 
String[]selecticnArgs, String graucBy, String having, String orderBy) 


3 8.6 query() 函 数 的 参数 说 明 


位 E 类 型 十 名 称 说 — m 
1 String table 表 名 称 
2 String[] columns 返回 的 属性 列 名 称 
3 String selection 查询 条 件 
Sel eolonities 如 果 在 查询 条 件 中 使 用 通配符 (?) , 则 需要 在 这 里 定 
义 蔡 换 符 的 具体 内 容 
5 String groupBy 分 组 方式 
6 String having 定义 组 的 过 滤器 
y String orderBy 排序 方式 


下 面 分 别 给 出 根据 id 查询 数据 和 查询 全 部 数据 的 代码 。 


N public People[] getOneData (long id) { 


3 return Convert ToPecple (results); 


2 Cursor results- db.query (DB TAHIE, new String[](KEY ID, KEY NAME, KEY AGE, KEY HEIGHT), 
KEY ID "-"t id, null, null, null, null); 


1 public People[] getAllDeta() f 


3 return Convert ToPecple (results); 


2 Cursor results- db.query (DB TAHIE, new String[] ( KEY ID, KEY NAME, KEY AŒ, KEY - 
HEIGHT), null, null, null, null, null); 


208 


A 


SQLiteDemo 是 对 SQLite 数据 库 进行 操作 的 示例 ， 
如 图 8. 12 所 示 。 在 这 个 示例 中 ,用 户 可 以 在 界面 的 上 方 ， 国 ES 
输入 数据 信息 ,通过 “添加 数据 ”按钮 将 数据 写 人 数据库。 EIUS 
“全 部 显示 ”按钮 相当 于 查询 数据 库 中 的 所 有 数据 ,并 将 E 
数据 显示 在 界面 下 方 。“ 清 除 显示 ”按钮 仅 是 清除 在 界面 ， 遍 讲 认 | 
下 方 显示 的 数据 ,而 不 对 数据 库 进行 任何 操作 。“ 全 部 删 z ee ees ML 
除 ” 按 钮 是 数据 库 操作 ,将 删除 数据 库 中 的 所 有 数据 。 在 
界面 中 部 ,以 “ID 十 功能 "命名 的 按钮 ,分 别 是 根据 ID 删 
除数 据 、 查 询 数 据 和 更 新 数据 ,而 这 个 ID 值 就 取 自 这 三 
个 按钮 左 侧 的 EditText 控件 。 这 里 不 再 给 出 SQLiteDemo 
示例 的 代码 。 


ID 删除 ID 查询 DEF 


图 8.12 SQLiteDemo 用 户 界 面 


84 数据 共享 


Android 应 用 程序 运行 在 不 同 的 进程 空间 中 ,因此 不 同 应 用 程序 的 数据 是 不 能 够 直接 
访问 的 。 为 了 增强 程序 之 间 的 数据 共享 能 力 ,Android 系统 提供 了 像 SharedPreferences 这 
类 类 简单 的 跨越 程序 边界 的 访问 方法 ,但 这 些 方 法 都 存在 一 定 的 局 限 性 。 
ContentProvider( 数 据 提供 者 ) 是 应 用 程序 之 间 共 享 数据 的 一 种 接口 机 制 ,是 一 种 更 为 高 
级 的 数据 共享 方法 ,可 以 指定 需要 共享 的 数据 ,而 其 他 应 用 程序 则 可 以 在 不 知道 数据 来 
源 、 路 径 的 情况 下 ,对 共享 数据 进行 查询 添加、 删除 和 更 新 等 操作 。 


841 ContentFrovder 


Android 系统 中 ,许多 Android 系统 内 置 的 数据 也 是 通过 ContentProvider 提供 给 用 
户 使 用 ,例如 通讯 录音 视频 文件 和 图 像 文件 等 。 

在 创建 ContentProvider 前 .首先 要 实现 底层 的 数据 源 ,数据 源 包括 数据 库 、 文 件 系 
统 或 网 络 等 ,然后 继承 ContentProvider 类 中 实现 基本 数据 操作 的 接口 函数 ,包括 添加 、 
删除 .查找 和 更 新 等 功能 。 调 用 者 不 能 直接 调用 ContentProvider 的 接口 函数 ,而 需要 使 
用 ContentResolver XJ 4.38 it URI 间接 调用 ContentProvider, 调用 关系 如 图 8. 13 
所 示 。 


ContentResolver [URL | ContentProvider 


文件 系统 数据 库 网 络 


图 8. 13 ContentProvider 调用 关系 


在 ContentResolver 对 象 与 ContentProvider 进行 交互 时 ,通过 URI 确定 要 访问 的 
ContentProvider 数据 集 。 在 发 起 一 个 请 求 的 过 程 中 ,Android 系统 根据 URI 确定 处 理 这 
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个 查询 的 ContentProvider, 然 后 初始 化 ContentProvider 所 有 需要 的 资源 ,这 个 初始 化 的 
工作 是 Android 系统 完成 的 ,无 需 程 序 开 发 人 员 参 与 。 一 般 情 况 下 只 有 一 个 
ContentProvider 对 象 ,但 却 可 以 同时 与 多 个 ContentResolver 进行 交互 。 

ContentProvider 完全 屏蔽 了 数据 提供 组 件 的 数据 存储 方法 。 在 程序 开发 人 员 看 来 ， 
数据 提供 者 通过 ContentProvider 提供 了 一 组 标准 的 数据 操作 接口 ,但 却 无 须知 道 数据 
提供 者 的 内 部 数据 的 存储 方法 。 数 据 提供 者 可 以 使 用 SQLite 数据 库存 储 数 据 , 也 可 以 
通过 文件 系统 或 SharedPreferences 存储 数据 ,甚至 是 使 用 网 络 存储 的 方法 ,这 些 数据 的 
存储 方法 和 存储 设备 对 数据 使 用 者 都 是 不 可 见 的 。 同 时 ,也 正 是 这 种 屏蔽 模式 ,很 大 程 
度 上 简化 了 ContentProvider 的 使 用 方法 ,使 用 者 只 要 调用 ContentProvider 提供 的 接口 
函数 , 即 可 完成 所 有 的 数据 操作 ,而 数据 存储 方法 则 是 ContentProvider 设计 者 需要 考虑 
的 问题 。 

ContentProvider 的 数据 集 类 似 于 数据 库 的 数据 表 , 每 行 是 一 条 记录 ,每 列 具 有 相同 
的 数据 类 型 ,如 表 8.7 所 示 。 每 条 记录 都 包含 一 个 长 整 型 的 字段 _ID, 用 来 唯一 标识 每 条 
记录 。ContentProvider 可 以 提供 多 个 数据 集 , 调 用 者 使 用 URI 对 不 同 数据 集 的 数据 进 
行 操作 。 


表 8.7  ContentProvider 数据 集 


_ID NAME AGE HEIGHT 
Tom 21 1.81 
2 Jim 22 1.78 


URI 是 通用 资源 标志 符 (Uniform Resource Identifier) ,用 来 定位 远程 或 本 地 的 可 用 资 
源 。ContentProvider 使 用 的 URI 语法 结构 如 下 。 


content://< authority» /< data path» /< id» 


其 中 ,content:// 是 通用 前 级 ,表示 该 URI 用 于 ContentProvider 定位 资源 ,无 须 修 
改 。 志 authority 二 是 授权 者 名 称 , 用 来 确定 具体 由 哪 一 个 ContentProvider 提供 资源 。 
因此 ,一 般 二 authority 二 都 由 类 的 小 写 全 称 组 成 ,以 保证 唯一 性 。 二 data_path 二 是 数据 
路 径 , 用 来 确定 请 求 的 是 哪个 数据 集 。 如 果 ContentProvider 仅 提 供 一 个 数据 集 ,数据 路 
径 则 是 可 以 省 略 的 。 但 如 果 ContentProvider 提供 多 个 数据 集 , 数 据 路 径 则 必须 指明 具 
体 是 哪 一 个 数据 集 。 数 据 集 的 数据 路 径 可 以 写成 多 段 格式 ,例如 people/girl 和 /people/ 
boy。 去 id> 是 数据 编号 ,用 来 唯一 确定 数据 集中 的 一 条 记录 ,用 来 匹配 数据 集中 _ID F 
段 的 值 。 如 果 请 求 的 数据 并 不 只 限于 一 条 数据 , 则 过 id 之 是 可 以 省 略 的 。 

例如 ,请 求 整个 people 数据 集 的 URI 应 写 为 : 


content ://edu.hrbeu.peopleprovider/people 


而 请 求 people 数据 集中 第 3 条 数据 的 URI 则 应 写 为 : 
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content ://edu.hrbeu.peopleprovider/people/3 


842 创建 数据 提供 者 


程序 开发 人 员 通 过 继承 ContentProvider 类 可 以 创建 一 个 新 的 数据 提供 者 ,过 程 可 
以 分 为 三 步 ， 

CD 继承 ContentProvider. JF 3E Z 6 个 函数 ; 

(2) 声明 CONTENT_URI, 实 现 UriMatcher; 

(3) 注册 ContentProvider。 

下 面 按照 上 述 的 三 个 步骤 ,分 步骤 地 说 明 创建 数据 提供 者 的 过 程 。 


1. 继承 ContentProvider, 并 重 载 6 个 函数 


新 建立 的 类 继承 ContentProvider 后 ,共有 6 个 函数 需要 重 载 ,分 别 是 delete O, 
get TypeO ,insert() ,onCreateO ,query O fll update()。 其 中 ,delete() ,insert O .query() 
和 update() 分 别 用 于 对 数据 集 的 删除 .添加 ,查询 和 更 新 操作 ,程序 开发 人 员 根据 底 层 数 
据 的 存储 方式 不 同 , 使 用 不 同方 式 实现 数据 操作 。 而 onCreate() 一 般 用 来 初始 化 底层 数 
据 集 和 建立 数据 连接 等 工作 。getType() 函 数 用 来 返回 指定 URI 的 MIME 数据 类 型 ,如 
果 URI 是 单条 数据 , 则 返回 的 MIME 数据 类 型 应 以 vnd. android. cursor. item 开头 ;如 果 
URI 是 多 条 数据 , 则 返回 的 MIME 数据 类 型 应 以 vnd. android. cursor. dir/ 开 头 。 

新 建立 的 类 继承 ContentProvider 后 . Eclipse 会 提示 程序 开发 人 员 需 要 重 载 部 分 的 
代码 ,并 自动 生成 需要 重 载 的 代码 框架 。 下 面 的 代码 是 Eclipse 自动 生成 的 代码 框架 。 


import android.content. * ; 
inport android.database.Cursor; 
import android.net.Uri; 


&Override 
public int delete(Uri uri, String selection, String[] selectionArgs) { 


1 

2 

3 

4 

5  pblic class PecpleProvider extends ContentProvider( 
6 

7 

8 

9 //TOD Anto- generated method stub 


10 retum 0; 

1 ; 

12 

13 GOverride 

14 püblic String getType (Uri uri) ( 

15 //TOD Anto- generated method stub 
16 retum null; 
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GOverride 

public boolean onCreate() ( 
//'IODO Auto- generated method stub 
return false; 


GOverride 


public Cursor query (Uri uri, String[] projection, String selection, 


String[] selectionArgs, String sortOrder) ( 
//'10DO Auto- generated method stub 
return null; 


GOverride 


public int update(Uri uri, ContentValues values, String selection, 


String[] selectionArgs) ( 
//TODD Anto- generated method stub 
return 0; 


2. 声明 CONTENT URI. 3:3. UriMatcher 


在 新 构造 的 ContentProvider 类 中 ,经 常 需要 判断 URI 是 单条 数据 还 是 多 条 数据 ,最 
简单 的 方法 是 构造 一 个 UriMatcher。 同 时 ,为 了 便于 判断 和 使 用 URI, 一 般 将 URI 的 授 


权 者 名 称 和 数据 路 径 等 内 容声 明 为 静态 常量 ,并 声明 CONTENT URI, 


声明 CONTENT URI 和 构造 UriMatcher 的 代码 如 下 。 


心 wm 


püblic static final String AUTECRITY- "edu.hrbeu.peopleprovider"; 
public static final String PATH SINGIE- "people/£ "; 

public static final String PATH MULTIPIE- "people"; 

public static final String OONTENT URI STRING- "content: //"-- AUTHORITY "/"+ 
PATH MJLTIPIE; 

public static final Uri CONTENT URI-Uri.parse (CONTENT URI STRING); 
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6 private static final int MJLTIPIE PEOPIF= 1; 

T private static final int SINGIE PEOPIF= 2; 

8 

9 private static final UriMatcher uriMat her; 

10 static { 

n uriMatcher- new UriMatcher (UriMatcher.NO MATCH); 

12 uriMatcher.addURI (AUTHORITY, PATH SINGIE, MULTIPLIE PEDPIE); 
13 uriMatcher.acHURI(AUTHORITY, PATH MULTIPIE, SINGIE FEDPIE); 
u ] 


代码 第 1 行 声明 了 UR 的 授权 者 名 称 ,第 2 行 声明 了 单条 数据 的 数据 路 径 ,第 3 行 
声明 了 多 条 数据 的 数据 路 径 , 第 4 行 声明 了 CONTENT_URI 的 字符 串 形式 ,第 5 行 则 正 
式 声明 了 CONTENT_URI, 第 6 行 声明 了 多 条 数据 的 返回 代码 ,第 7 行 声 明了 单条 数据 
的 返回 代码 。 第 9 行 声明 了 UriMatcher, 并 在 第 10 行 一 第 13 行 的 静态 构造 函数 中 , 声 
明了 UriMatcher 的 匹配 方式 和 返回 代码 。 其 中 ,在 第 11 行 UriMatcher 的 构造 函数 中 ， 
UriMatcher. NO MATCH Æ URI 无 匹配 时 的 返回 代码 。 第 12 行 的 addURI() 函数 用 


来 添加 新 的 匹配 项 ,语法 为 : 


public void addURI (String authority, String path, int code) 


其 中 ,authority 表示 匹配 的 授权 者 名 称 ,path 表示 数据 路 径 ,# 可 以 代表 任何 数字 ,code 


表示 返回 代码 。 
使 用 UriMatcher 时 , 则 可 以 直接 调用 match() 函 数 ,对 指定 的 URI 进行 判断 ,示例 

代码 如 下 。 

1 Switch (uriMatcher.match (uri))( 

FA case MJLTIPIE PEOPIE: 

3 // 多 条 数据 的 处 理 过 程 

4 break; 

5 case SINGIE PEDPIE: 

6 // 单 条 数据 的 处 理 过 程 

7 break; 

8 default: 

9 throw new IllegalArgurentException ("R c f$ ff] URI:"+uri); 

10 } 


3. 注册 ContentProvider 


在 完成 ContentProvider 类 的 代码 实现 后 ,需要 在 AndroidManifest. xml 文件 中 进行 


注册 。 注 册 ContentProvider 使 用 二 provider 二 标签 .示例 代码 如 下 : 
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«applicaticn android:icon- "@drawable/iomn" android:label- "Gstring/agp name" 
« provider android:name- ".PeopleProvider" 
android:authorities- "edu.hrbeu.peopleprovider"/» 
< /application» 


1 
2 
3 
4 


在 上 面 的 代码 中 ,注册 了 一 个 授权 者 名 称 为 edu. hrbeu. peopleprovider 的 Content- 
Provider, 其 实现 类 是 PeopleProvider。 


843 使 用 数据 提供 者 


使 用 ContentProvider 并 不 需要 直接 调用 类 中 的 数据 操作 函数 ,而 是 通过 Android 
组 件 都 具有 的 ContentResolver 对 象 ,通过 URI 进行 数据 操作 。 程 序 开发 人 员 只 需要 知 
道 URI 和 数据 集 的 数据 格式 , 则 可 以 进行 数据 操作 ,解决 不 同 应 用 程序 之 间 的 数据 共享 
问题 。 

每 个 Android 组 件 都 具有 一 个 ContentResolver 对 象 ,获取 ContentResolver 对 象 的 
方法 是 调用 getContentResolver O 函数 。 


ContentResolver resolver- getContentResolver () ; 


1. 查询 操作 


在 获取 到 ContentResolver 对 象 后 ,程序 开发 人 员 可 以 使 用 query O 函数 查询 目标 数 
据 。 下 面 的 代码 是 查询 ID 为 2 的 数据 。 


String KEY ID-" id"; 

String KEY NAME- "name"; 
String KEY AGE- "age"; 
String KEY HEIGHT- "height"; 


Uri uri= Uri .parse (OONTENT URI STRING* "/"4 "2"; 
Cursor cursor- resolver.query (uri, 
newString[] (KEY ID, KEY NAME, KEY AGE, KEY HEIGHT], null, null, null); 


Oo - oO U e QU I Hn 


从 上 面 的 代码 不 难看 出 ,在 UR 中 定义 了 需要 查询 数据 的 ID 后 ,在 query O PR CIR 
则 没有 必要 再 加 入 其 他 的 查询 条 件 。 如 果 需 要 获取 数据 集中 的 全 部 数据 , 则 可 直接 使 用 
CONTENT_URI, 此 时 ContentProvider 在 分 析 URI 时 将 认为 需要 返回 全 部 数据 。 

ContentResolver 的 query O 函数 与 SQLite 数据 库 的 query O 函数 非常 相似 ,语法 结 
构 如 下 。 


Cursor query (Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) 
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uri 定 义 了 查询 的 数据 集 ,projection 定义 了 应 返回 数据 的 属性 ,selection 定义 了 返 
回 数据 的 查询 条 件 。 
2. 添加 操作 


向 ContentProvider 中 添加 数据 有 两 种 方法 ,一 种 是 使 用 insert CO 函数 ,向 
ContentProvider 中 添加 一 条 数据 ; 另 一 种 是 使 用 bultInsert() 函 数 , 批 量 地 添加 数据 。 下 
面 的 代码 说 明了 如 何 使 用 insert() 函数 添加 单条 数据 。 


ContentValues values- new ContentValues ()7 
values.put(KEY NAME, "Tom"); 
values.put(KEY ACE, 21); 

values.put(KEY HEIGHT, 1.81f); 


ao mw I PP 


Uri newUri= resolver.insert (OONTENT URI, values); 


下 面 的 代码 说 明了 如 何 使 用 bultInsert() 函 数 添加 多 条 数据 。 


1 ContentValues[] arrayValues- new ContentValues [10]; 
2 /实例 化 每 一 个 ContentValues 
3 int count- resolver.bultInsert (ONTENT URI, arrayValues); 


3. 删除 操作 


删除 操作 需要 使 用 delete O 函数 。 如 果 需 要 删除 单条 数据 , 则 可 以 在 URI 中 指定 需 
要 删除 数据 的 ID。 如果 需要 删除 多 条 数据 , 则 可 以 在 selection 中 声明 删除 条 件 。 下 面 
代码 说 明了 如 何 删除 ID 为 2 的 数据 。 


1 Uriuri-Uri.parse(ONNIENT URI SIRING* "/"+ "2"); 
2 int result- resolver.delete (uri, null, null); 


也 可 以 在 selection 语句 中 将 删除 条 件 定 义 为 ID 大 于 4 的 数据 : 


1 String selection= KEY ID "> 4"; 
2 int result- resolver.delete (CONTENT URI, selection, null); 


4. 更 新 操作 


更 新 操作 需要 使 用 update O 函数 ,参数 定义 与 delete() 函数 相同 ,同样 可 以 在 URI 
中 指定 需要 更 新 数据 的 ID ,也 可 以 在 selection 中 声明 更 新 条 件 。 下 面 代码 说 明了 如 何 
更 新 ID 为 7 的 数据 。 
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和 ContentValues values- new ContentValues () ; 
2 values.put(KEY NAME, "Tom"); 
values.put(KEY ACE, 21); 

values.put(KEY HEIGHT, 1.81f); 


Uri uri-Uri.parse(CONIENT URI SIRING "/"+ "7"); 
int result- resolver.update (uri, values, null, null); 


844 示例 


ContentProviderDemo 是 一 个 无 界面 的 示例 , 仅 提 供 


-个 ContentProvider 组 件 , 供 


其 他 应 用 程序 进行 数据 交换 。 底 层 使 用 SQLite 数据 库 , 支 持 数 据 的 添加 、 删 除 、 更 新 和 


查询 等 基本 操作 。ContentResolverDemo 是 调用 
ContentProvider 的 示例 ,自身 不 具有 任何 数据 存储 
功能 , 仅 是 通过 URI 访问 ContentProviderDemo 示 
例 提供 的 ContentProvider。 界 面 如 图 8. 14 所 示 , 该 
界面 与 SQLiteDemo 示例 的 界面 基本 相同 。 

从 图 8. 15 的 文件 结构 上 可 以 发 现 ,两 个 示例 都 
包含 一 个 相同 的 文件 People. java, 两 个 示例 中 的 这 
个 文件 的 内 容 也 完全 相同 ,定义 了 数据 提供 者 和 数据 
调用 者 都 必须 知道 的 信息 。 这 些 信息 包括 授权 者 名 
称 .数据 路 径 .MIME 数据 类 型 CONTENT_URI 和 
数据 项 名 称 等 。 

下 面 分 别 给 出 People. java 文件 .PeopleProvider. 


| ContentResolverDemo 
jimmy 
8 
LES] 


添加 数 。 全 部 显 
据 示 


ID 删除 


清除 显 SM 
示 除 


ID 查询 “ID 更 新 


8.14 ContentResolverDemo 用 户 界面 


java 文 件 和 ContentResolverDemoActivity. java 文件 的 完整 代码 ,最 后 分 别 给 出 
ContentProviderDemo 示例 和 ContentResolverDemo 示例 的 AndroidManifest. xml 文件 内 容 。 


4 因 ContentProviderDemo 
4 (9 src Bsr 
4 8B eduhrbeu.ContentProviderDemo 


B) Peoplejava 


国 PeopleProvider java 


3| AndroidManifestxml 


[8) proguard.cg 


B) project properties 2 


(a) ContentProviderDemo 


图 8.15 


名 gen [Generated Java Files] Ës gen [Ge 
mÀ Android 4.0 EÀ Android 4.0 
D assets Jj D assets 
& bin & 
& res & res 


4 (e$ ContentResolverDemo 


4 Bi edu.hrbeu.ContentResolverDemo 
DD ContentResclverDemoActivity java 


国 Peoplejava 


nerated Java Files] 


À AndroidManifest xml 
proguard.cfg 
B project properties E 


(b) ContentResolverDemo 


示例 的 文件 结构 
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People. java 文件 的 完整 代码 : 
1 padage edu.hrbeu.ContentResolverDem; 
2 import android.net.Uri; 
3 
4 public class People{ 
5 
6 public static final String MIME DIR PREFIX- "vnd.android.cursor.dir"; 
1 public static final String MIME TTEM PREFIX- "vnd.android.cursor. ite"; 
8 public static final String MINE TTEM- "vnd.hrbeu.people"; 
9 
10 public static final String MINE TYPE SINGLE-MIME ITEM PREFIX: 
n public static final String MINE TYPE MJLTIPIE-MIME DIR PREFIX* 
12 
13 public static final String AUTHORTTY- "edu.hrbeu.peopleprovider"; 
14 public static final String PATH SINGLE- "people/£ "; 
15 piblic static final String PATH MJLTIPIE- "people"; 
16 public static final String OONTENT URI STRING- "content ://"+ AUTHORITY 
+ "/"- PATH MILTIBIE; 
17 pdblic static final Uri OONTENT URI-Uri.parse (CONTENT URI STRINS); 
18 
19 piblic static final String KEY ID-" id"; 
20 piblic static final String KEY NAME= "name"; 
E piblic static final String KEY ACE- "age"; 
22 public static final String KEY HEIGHT- "height"; 
23 


PeopleProvider. java 文件 的 完整 代码 : 


package edu.hrbeu.ContentProviderDemo; 


import android.content.ContentProvider; 

import android.content.ContentUris; 

inport android.content .ContentValues; 

import android.content.Context; 

import android.content.UriMatcher; 

inport android.database.Cursor; 

import android.database.SQLException; 

import android.database.sqlite.SQgLiteDatabase; 
import android.database.sqlite.SQgLiteOpenBelper; 
import android.database.sqlite.SQLiteQueryBuilder; 
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import android.database.sqlite.SgLiteDatabase.CursorFactory; 
inport android.net.Uri; 


public class PeopleProvider extends ContentProvider( 


private static final String DB NAME- "people.db"; 
private static final String DB TAHIE- "peopleinfo"; 
private static final int DB VERSION- 1; 


private SQLiteDatabase db; 
private DBOpenHelper doOpenHelper; 


private static final int MULTIPLIE PEDPIE- 1; 
private static final int SINGIE PEOBLE- 2; 
private static final UriMatcher uriMatcher; 


static ( 
uriMatcher- new UriMatcher (UriMatcher.NO MATCH); 
uriMatcher.addURI (People.AUTHORTTY, Pecple.PATH MULTIPLE, MULTIPIE - 
PEDPIE) ; 
uriMatcher.addURI(People.AUTHORTTY, People.PATH SINGIE, SINGIE - 
PEDPIE) 7 


GOverride 
Public String getType (Uri uri) ( 
Switch (uriMatcher.match (uri) ) ( 
case MJLTIPIE PROPIE: 
return People.MINE TYPE MULTIPLIE; 
case SINGIE PEDHIE: 
return People.MINE TYPE SINGIE; 
default: 
throw new IllegalArgumentException ("Unkown uri:"+ uri); 


override 
public int delete(Uri uri, String selection, String[] selectionArgs) ( 
int count- 0; 
switch(uriMatcher.match (uri) ) ( 
case MJLTIEIE PEDPIE: 
count-db.delete(IB TABIE, selection, selectionArgs); 
break; 
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Case SINGIE PEOPIE: 
String segrent- uri .getPathSegrents () .get (1) ; 
count-db.delete(TB TABIE, People.KEY ID* "= "+ segrent, 
selectionArgs); 
break; 
default: 
throw new I1legalArgumentException ("Unsupported URI:"+ uri); 
} 
getContext () .getContentResolver () .notifyChange (uri, null); 
return count; 


GOverride 
public Uri insert (Uri uri, ContentValues values) { 
long id-db.insert(DB TABIE, null, values); 
if(id»0)( 
Uri newUri= ContentUris.withhppendedId(Pecple.CONTENT URI, id); 
getContext () .getContentResolver () .notifyChange (newUri, null); 
retum newUri; 
) 
throw new SQLException ("Failed to insert row into "+ uri); 


GOverride 
public boolean onCreate() ( 
Context context- getContext () 7 
abopenHelper= new DBOpenHelper (oontext, IB NPME, null, IB VERSION); 
db- doopenBelper .getiritableDatabase () ; 


if(do-- null) 
retum false; 
else 
retum true; 


QOverride 
public Cursor query (Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) ( 
SQLiteQueryBuilder do- new SoüLiteQueryguilder(); 
db.setTables(DB TAHIE) ; 
switch (uriMatcher.match (uri) ( 
Case SINGIE PEOPIE: 
cb-agpendibere Peple KEY IDE "= "ruri .getfattegrents () get (1)); 
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sortOrder) ; 
cursor.setNotificationUri (getContext () .getContentResolver(), uri); 
return cursor; 


GOverride 
public int update (Uri uri, ContentValues values, String selection, 
String[] selectionArgs) ( 
int count; 
switch (uriMatcher.match (uri)) ( 
case MJLTIPIE PEDPIE: 
count= db.update (B. TEIE, values, selection, selectionhrgs) ; 
break; 
Case SINGLE PEDHIE: 
String segrent- uri .getPathSegrents () .get (1) ; 
count- db.update(TB TABIE, values, Pecple.KEY ID+ "- "4 
segment, selectionArgs); 
break; 
default: 
throw new IllegalArgumentException ("Unknow URI:"+ uri); 
) 
getContext () .getContentResolver () .notifyChange (uri, null); 
return count; 


private static class DBOpenHelper extends SQLiteOpenHelper { 


public DBopenHelper (Context context, String name, CursorFactory 
factory, int version) { 
Super(context, name, factory, version); 
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137 private static final String IB. CREATE- "create table "+ 

138 IB THIE-"("-Pegple.KEY ID+ " integer primary key autoincrement, "+ 

139 Beople.KEY NAME" text not null, "+ People.KEY AGE& " integer,"4- 
People.KEY HEIGHT+ " float);"; 

140 

141 GOverride 

142 public void onCreate (SQLiteDatabase db) { 

143 . do.execSQL(IB CREATE); 

144 ] 

145 

146 GOverride 

147 public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) { 

148 . Gb.execSQL("LFOP TARIE IF FXISTS "+ TB. TAHIE) ; 

149 oncreate( db); 

150 } 

151 } 

152 } 


ContentResolverDemoActivity. java 文件 的 完整 代码 : 


X package edu.hrbeu.ContentResolverDemo; 


import android.app.Activity; 

import android.content.ContentResolver; 
import android.content.ContentValues; 
import android.database.Cursor; 

import android.net.Uri; 

import android.os.Bundle; 

10 import android.view.View; 

ll import android.view.View.OnClickListener; 
12 import android.widget.Button; 

13 import android.widget.EditText; 

14 import android.widget.TextView; 


€ 0 - Oo UO mw 


15 
16 public class ContentResolverDenictivity extends Activity { 
17 

18 private EditText nameText; 

19 private EditText ageText; 

20 private EditText heightText; 

2 private EditText idEntry; 
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private TextView labelView; 
private TextView displayView; 


private ContentResolver resolver; 


GOverride 

public void onCreate (Bundle savedInstanceState) { 
Super.anCreate (savedInstanoeState) ; 
setContentView (R. layout main) ; 


nameText- (EditText) findViewById(R.id.name); 
ageText- (EditText) findViewById(R.id.age); 
heightText- (EditText) findViewById (R. id.height); 
idEntry- (EditText) findViewById(R.id.id entry); 


labelView- (TextView) findViewById (R.id.label); 
displayiew- (TextView) findViewById(R.id.display); 


Button adcButton- (Button) finaViesById(R. id.add) ; 

Button queryAllButtcn- (Button) findViesByTd R.id.query all); 
Button clearButton- (Button) fincViesById (R. id.clear); 

Button deleteAl]Button- (Button) fincViewById(R.id.delete all); 


Button queryButton- (Button) findViewById (R.id.query); 
Button deleteButton- (Button) findViewById(R.id.delete) ; 
Button updateButton- (Button) findViewById|(R.id.update); 


addButton.setonClickListener (addButtonListener) ; 
queryAllButton.setOnClickListener (queryAllButtonListener) ; 
ClearButton.setOnClickListener (clearButtonListener) ; 
deleteAl]Button.setOnClickListener (deleteAlButtonListener) ; 
queryButton.setOnClickListener (queryButtonLi stener) ; 
deleteButton.setOnClickListener (deleteButtonListener) ; 


updateButton.setOnClickListener (updateButtonListener); 


resolver- this.getContentResolver () 7 
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66 
61 OnclickListener addButtonListener- new OnClicktistener() ( 
68 GOverride 
69 püblic void onClick (View v) ( 
70 ContentValues values- new ContentValues () ; 
75 
7 values.put(People.KEY NAME, nameText.getText () .toString()) ; 
7 values.put(People.KEY ACE, Integer.parseInt (ageText .getText () .toString())) ; 
74 values.put(People.KEY HEIGHT, Float.parseFloat (heightText. 
getText () -toString ())) ; 
75 
76 Uri newUri- resolver.insert (People.OONTENT URI, values); 
TI 
78 labelView.setText ("添加 成 功 ,URI:"+ newUri) ; 
79 
80 ) 
8l F 
82 
83 OnclickListener queryAllButtonListener- new OnClickListener() { 
84 GOverride 
85 public void onClick (View v) ( 
86 Cursor cursor- resolver.query (Pecple.OONTENT URI, 
87 new String[] ( Pecple.KEY ID, People.KEY NAME, Pecple.KEY ACE, People. 
KEY HEIGHT], 
88 null, null, null); 
89 if(cursor-- null) ( 
90 labelView.setText ("数据 库 中 没有 数据 "); 
91 retum; 
D ) 
93 labelView.setText (数据 库 : "+ String.valueof (cursor.getCount ())+ "AK id R"); 
94 
95 String msg- ""; 
96 if (cursor.moveToFirst () ) ( 
97 do( 
98 msg+ = "ID: "+ cursor.getInt (cursor.getColumnIndex (Pecple.KEY ID))* ","; 
99 msgt — "姓名 : "+ cursor.getString (cursor.getColumIndex 
(People.KEY NAME))*","; 
100 msg+ = "年 龄 : "+ cursor.getInt (cursor.getColumnIndex (Pecple.KEY ACE)) 
qe TE 
101 msgt= "身高 : "+ cursor.getFloat (cursor.getColumIndex 
(People.KEY HEIGHT))- "^n"; 
102 Jwhile(cursor.moveToNext () ) ; 
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103 
104 
105 
106 
107 
108 
109 


118 
119 
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F 
OnClickListener clearButtonListener- new OnClickListener() { 


GOverride 
public void onClick (View v) ( 
displayiew.setText ("") ; 


IB 


OrclickListener deleteAllButtonListener- new Onclicklistener() { 
override 
public void onClick (View v) ( 
resolver.delete (Pecple.CONIENT URI, null, null); 
String neg- "cd 4: WM E " ; 
labelView.setText (msg); 


F 


OnClickListener queryButtonListener= new OnClickListener() { 
GOverride 
public void onClick (View v) ( 
Uri uri- Uri.parse(People.OONTENT URI STRING "/"+ idEntry 
-getText () .toString()) ; 
Cursor cursor- resolver.query (uri, 
new String[] ( People.KEY ID, People.KEY NAME, People.KEY - 
ACE, Pecple.KEY HEIGHT), 
ml, null, nul); 
if(cursor- = null) ( 
labelView.setText ("Ht s He vp ito HS m; 
retum; 


String msg- ""; 

if(cursor.moveToFirst ()) { 
msg+ = "ID: "+ cursor.getInt (cursor.getColumIndex (People.KEY 
ey 
msgt— "姓名 : "+ cursor.getString (cursor.getColumIndex 
(Fecple.KEX NAME) ","; 
msgt= "E fit : "+ cursor.getInt (cursor.getColumIndex (People 
KEY AŒ))+", "; 
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169 
170 


171 
172 
173 


174 
175 
176 
17 


msg+ = "身高 : "+ cursor. getFloat (cursor. getColumnIndex (People. KEY _ 
HEIGHT) )+ "An"; 


F 


OnClickListener deleteButtonListener- new OnClickListener () ( 
GoOverride 
public void onClick (View v) ( 


Uri uri- Uri.parse(People.OONTENT URI STRINGH "/"+ idEntry 

.getText () .toString()) ; 

int result- resolver.delete (uri, null, null); 

String msg- "lll KÈ ID Jj "+ idEntry.getText () .toString () - "的 数据 "+ (result> 
"RJ ni" AW); 

labelView.setText (msg) ; 


F 


OnClickListener updateButtonListener- new OnClickListener() { 
GOverride 
public void onClick (View v) ( 
ContentValues values- new ContentValues () ; 


values.put(People.KEY NAME, nameText.getText () .toString()); 
values.put(People.KEY ACE, Integer.parseInt (ageText.getText () 
-toString)); 

values.put(People.KEY HEIGHT, Float.parseFloat (heightText. 
getText () .toString ()))7 


Uri uri- Uri.parse(People.CONTENT URI STRING* "/"+ idEntry 
-getText () .toString()) ; 
int result- resolver.update (uri, values, null, null); 


String msg- "更新 ID JJ "+ idEntry.getText () .toString()+" 的 数据 "+ (result> 
"RH "R K"); 


labelView.setText (msg) ; 


F 
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ContentProviderDemo 示例 的 AndroidManifest. xml 文件 内 容 。 


Ov C) wm PP 


10 
11 


<?xml version- "1.0" encoding- "utf- 8"?» 
«manifest xmlns:android- "http: //schemas .android.con/apk/res/android" 
package- "edu.hrbeu.ContentProviderDemo" 
android:versionCode- "1" 
android:versionName- "1.0" 
< application android:icon- "@drawable/icon" android:label- "estring/app 
name" 
< provider android:name- ".PeopleProvider" 
android:authorities- "edu.hrbeu.peopleprovider"/» 
< /application» 
< uses- sdk android:minSdkVersion- "3"/» 
< /ranifest> 


ContentResolverDemo 示例 的 AndroidManifest. xml 文件 内 容 。 


o Oc c QI PP 


o u 


<?xml version- "1.0" encoding- "utf- 8"?> 
«manifest xmlns:android= "http: //schemas .android.caw'apk/res/android" 
package- "edu.hrbeu.ContentResolverDemo" 
android:versionOode- "1" 
android:versionName- "1.0"? 
< application android:icon- "Gdraweble/icon" android:label- "éstring/app 
name"? 
« activity android:name- ".ContentResolverDemo" 
android:label- "Gstring/app name" 
< intent- filter» 
<action android:name- "android. intent .action.MAIN"/> 
< category ancdroid:name= "android. intent .category. LAUNCHER" /> 
< /intent- filter» 
< /activity> 
< /agplication» 
< uses- sdk android:minSdkVersion- "3"/» 
< /manifest^ 


1. 应 用 程序 一 般 允 许 用 户 自己 定义 配置 信息 ,如 界面 背景 颜色 、 字 体 大 小 和 字体 颜 
色 等 ,尝试 使 用 SharedPreferences 保存 用 户 的 自 定义 配置 信息 ,并 在 程序 启动 时 自动 加 


3 Es 


载 这 些 自 定义 的 配置 信息 。 


2. 尝试 把 第 1 题 的 用 户 自己 定义 的 配置 信息 ,以 INT 文件 的 形式 保存 在 内 部 存储 


器 上 。 
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3. 简 述 在 嵌入 式 系统 中 使 用 SQLite 数据 库 的 优势 。 
4. 分 别 使 用 手动 建 库 和 代码 建 库 的 方式 ,创建 名 为 test. db 的 数据 库 , 并 建立 staff 
数据 表 , 表 内 的 属性 值 如 表 8. 8 所 示 。 


表 8.8 staff 数据 表 


属 性 数据 类 型 说 明 属 性 数据 类 型 说 明 
id integer 主键 department text 所 在 部 门 
name text 姓名 salary float 工资 
Sex text 性 别 


5. 利用 第 4 题 建 立 的 数据 库 和 staff 表 , 为 程序 提供 添加 .删除 和 更 新 等 功能 ,并 学 
试 将 表 8. 9 中 的 数据 添加 到 staff 表 中 。 


38.9  peopleinfo 表 内 容 


id name sex department salary 
1 Tom male computer 5400 
2 Einstein male computer 4800 
3 Lily female 1.68 5000 
4 Warner male 
5 Napoleon male 


6. 建立 一 个 ContentProvider, 用 来 共享 第 4 题 建立 的 数据 库 。 


位 置 服务 与 地 图 应 用 


位 置 服务 和 地 图 应 用 是 发 展 最 为 迅速 .具有 潜在 需求 的 领域 。 通 过 本 章 的 学 习 可 以 
让 读者 了 解 位 置 服务 和 地 图 应 用 的 概念 .方法 和 技巧 ,并 使 用 Google 提供 的 地 图 服务 构 
建 具有 位 置 服务 功能 的 应 用 程序 。 

本 章 学 习 目标 : 

。 了解 位 置 服务 的 概念 ; 

。 了 解 地 图 密 钥 的 申请 方法 ; 

。 掌握 获取 位 置信 息 的 方法 ; 

e 掌握 MapView 和 MapController 的 使 用 方法 ; 

。 掌握 Google 地 图 覆盖 层 的 使 用 方法 。 
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位 置 服务 (Location-Based Services. LBS) .又 称 定位 服务 或 基于 位 置 的 服务 ,融合 了 
GPS 定位 、 移 动 通信 、 导 航 等 多 种 技术 ,提供 与 空间 位 置 相 关 的 综合 应 用 服务 。 位 置 服务 
首先 在 日 本 得 到 商业 化 的 应 用 。2001 年 7 月 ,DoCoMo 发 布 了 第 一 款 具 有 三 角 定 位 功能 
的 手持 设备 ,2001 年 12 月 ,KDDI 发 布 第 一 款 具 有 GPS 功能 的 手机 。 近 些 年 来 ,基于 位 
置 的 服务 发 展 更 加 迅速 ,涉及 商务 .医疗 .工作 和 生活 的 各 个 方面 ,为 用 户 提供 定位 、 追 踪 
和 敏感 区 域 警告 等 一 系列 服务 。 

Android 平台 支持 提供 位 置 服务 的 API, 在 开发 过 程 中 主要 使 用 LocationManager 
和 LocationProviders 对 象 。 

LocationManager 可 以 用 来 获取 当前 的 位 置 ,追踪 设备 的 移动 路 线 , 或 设 定 敏感 区 
域 ,在 进入 或 离开 敏感 区 域 时 设备 会 发 出 特定 警报 。LocationProviders 则 是 提供 定位 功 
能 的 组 件 集合 ,集合 中 的 每 种 组 件 以 不 同 的 技术 提供 设备 的 当前 位 置 , 区 别 在 于 定位 的 
精度 .速度 和 成 本 等 方面 。 

为 了 使 开发 的 程序 能 够 提供 位 置 服务 ,首先 的 问题 是 如 何 获取 LocationManager。 
获取 LocationManager 可 以 通过 调用 android. app. Activity. getSystemService O 函数 获 
取 , 代 码 如 下 。 
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1 String serviceString- Context.IOCATION SERVICE; 
2 IocatiarManager LocatiorMsnager- (Location Manager) getSysten&ervice (serviceString) ; 


代码 第 2 行 的 getSystemServiceO 函数 ,可 以 根据 服务 名 称 获 取 Android 提供 的 系 
统 级 服务 。 代 码 第 1 行 的 Context. LOCATION. SERVICE 指明 获取 的 是 位 置 服务 。 
Android 支持 的 系统 级 服务 如 表 9. 1 所 示 。 


表 9.1 Android 支持 的 系统 级 服务 

Context 类 的 静态 常量 值 返回 对 象 说 明 
LOCATION_SERVICE location LocationManager 控制 位 置 等 设备 的 更 新 
WINDOW_SERVICE window WindowManager 最 顶层 的 窗口 管理 器 
LAYOUT INFLATER SERVICE | layout_inflater | LayoutInflater 将 XML 资源 实例 化 为 View 
POWER_SERVICE power PowerManager 电源 管理 
ALARM_SERVICE alarm AlarmManager 在 指定 时 间接 受 Intent 
NOTIFICATION_SERVICE notification | NotificationManager | 后 台 事件 通知 
KEYGUARD_SERVICE keyguard KeyguardManager 锁定 或 解锁 键盘 
SEARCH_SERVICE search SearchManager 访问 系统 的 搜索 服务 
VIBRATOR_SERVICE vibrator Vibrator 访问 支持 振动 的 硬件 
CONNECTIVITY_SERVICE connection | ConnectivityManager | 网 络 连接 管理 
WIFI SERVICE wifi WifiManager Wi-Fi 连接 管理 
INPUT_METHOD_SERVICE |input_method | InputMethodManager | 输入 法 管理 


在 获取 LocationManager 后 ,还 需要 指定 LocationManager 的 定位 方法 ,然后 才能 够 调 

用 LocationManager. getLastKnowLocation( ) 方 法 获取 当前 位 置 。 目 前 LocationManager 中 
主要 有 两 种 定位 方法 ,分 别 是 使 用 GPS 定位 和 使 用 网 络 定位 。GPS 定位 可 以 提供 精确 的 
位 置信 息 , 但 定位 速度 和 质量 受到 卫星 数量 和 环境 情况 的 影响 。 网 络 定位 提供 的 位 置信 
息 精度 较 差 ,但 速度 较 GPS 定位 要 迅速 。LocationManager 支持 的 定位 方法 参考 表 9. 2。 
表 9.2 LocationManager 支持 的 定位 方法 


LocationManager d 
类 的 静态 常量 a UM 

T 5 | 使 用 GPS 定位 .利用 卫星 提供 精确 的 位 置信 息 ,需要 

人 android. permissions, ACCESS. FINE. LOCATION 用 户 权限 
使 用 网 络 定位 ,利用 基站 或 Wi-Fi 访问 提供 近似 的 位 置信 
— bi 息 , 需 要 具有 如 下 权限 : android. permission. ACCESS _ 
NETWORK PROVIDER | network | COARSE_LOCATION 或 android. permission, ACCESS _ 

FINE LOCATION 


在 指定 LocationManager 的 定位 方法 后 ,可 以 调用 getLastKnownLocation O J 15: 3k 
取 当 前 的 位 置信 息 。 以 使 用 GPS 定位 为 例 ,获取 位 置信 息 的 代码 如 下 : 


E String provider-locationManager.GPS PROVIDER; 
2a location location- locationManager.getlastKnownlocation (provider); 
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代码 第 2 行 返回 的 Location 对 象 中 ,包含 了 可 以 确定 位 置 的 信息 ,如 经 度 、 纬 度 和 速 
度 等 ,用 户 可 通过 调用 Location 中 的 getLatitude() 和 getLongitude() 方 法 分 别 获取 位 置 
信息 中 的 纬度 和 经 度 , 示 例 代码 如 下 : 


1 double lat- location.getlatitude () ; 
2 double lng location.getlongitude () ; 


在 很 多 提供 定位 服务 的 应 用 程序 中 ,不 仅 需要 获取 当前 的 位 置信 息 ,还 需要 监视 位 
置 的 变化 ,在 位 置 改变 时 调用 特定 的 处 理 方法 。LocationManager 提供 了 一 种 便捷 、 高 效 
的 位 置 监视 方法 requestLocationUpdates O ,可 以 根据 位 置 的 距离 变化 和 时 间 间 隔 设 定 ， 
产生 位 置 改变 事件 的 条 件 ,这样 可 以 避免 因 微小 的 距离 变化 而 产生 大 量 的 位 置 改变 事 
件 。LocationManager 中 设 定 监听 位 置 变 化 的 代码 如 下 : 


LocationManager.requestLocationUpdates (provider, 2000, 10, locationListener); 


第 1 个 参数 是 定位 的 方法 ,GPS 定位 或 网 络 定位 ;第 2 个 参数 是 产生 位 置 改变 事件 
的 时 间 间 隔 , 单 位 为 微 秒 ; 第 3 个 参数 是 距离 条 件 ,单位 是 米 ;第 4 个 参数 是 回调 函数 ,用 
于 处 理 位 置 改变 事件 。 上 面 的 代码 将 发 生 位 置 改变 事件 的 条 件 设 定 为 距离 改变 10 米 ， 
时 间 间 隔 为 2 秒 。 实 现 locationListener 的 代码 如 下 。 


1 IocationListener locationListener- new IocationListener() ( 

2 public void onLocationChanged (Location location) ( 

3 ) 

4 public void onProviderDisabled(String provider) ( 

5 ) 

6 public void onProviderknabled(String provider) ( 

7 ) 

8 public void onStatusChanged(String provider, int status, Bundle extras) ( 
9 


代码 第 2 行 的 onLocationChanged() 在 位 置 改变 时 被 调用 ,第 4 行 的 onProviderDisabled 
0) 在 用 户 禁用 具有 定位 功能 的 硬件 时 被 调用 ,第 6 行 的 onProviderEnabled() 在 用 户 启 用 有 具 
有 定位 功能 的 硬件 时 被 调用 ,第 8 行 的 onStatusChanged() 在 定位 功能 硬件 状态 改变 时 被 调 
用 ,例如 ,从 不 可 获取 位 置信 息 状 态 到 可 以 获取 位 置信 息 的 状态 ,反之 亦 然 。 

最 后 ,为 了 使 GPS 定位 功能 生效 .还 需要 在 AndroidManifest. xml 文件 中 加 入 用 户 
许可 ,代码 如 下 。 


«uses- permission android:name- "android.pemmission.AOCESS FINE IOCATION"/> 


CurrentLocationDemo 是 一 个 提供 基本 位 置 服务 的 示例 ,可 以 显示 当前 位 置信 息 ,并 


230 ons nas aom) 


能 够 监视 设备 的 位 置 变化 。CurrentLocationDemo 的 用 户 界 面 如 图 9. 1 所 示 。 

位 置 服务 一 般 都 需要 使 用 设备 上 的 硬件 ,最 理想 的 调试 方式 是 将 程序 上 传 到 物理 设 
备 上 运行 ,但 在 没有 物理 设备 的 情况 下 ,也 可 以 使 用 Android 模拟 器 提供 的 虚拟 方式 模 
拟 设备 的 位 置 变 化 ,调试 具有 位 置 服务 的 应 用 程序 。 首 先 打开 DDMS 中 的 模拟 器 控制 
AF. Æ Location Controls 中 的 Longitude 和 Latitude 部 分 输入 设备 当前 的 经 度 和 纬度 ， 
然后 点 击 Send 按钮 ,将 虚拟 的 位 置信 息 发 送 到 Android 模拟 器 中 ,如 图 9. 2 所 示 。 


@ Emulator Control 5: E 


Location Controls 可 


Manual [GPX | KML. 


© Decimal 

Sexagesimal 
Longitude -122.084095 1 
Latitude — 37.422006 


图 9.1 CurrentLocationDemo 示例 界面 图 9.2 模拟 位 置信 息 
在 程序 运行 过 程 中 ,可 以 在 模拟 器 控制 器 中 改变 经 度 和 纬度 坐标 值 , 程 序 在 检测 到 


位 置 的 变化 后 ,会 将 最 新 的 位 置信 息 显 示 在 界面 上 。 
下 面 给 出 CurrentLocationDemo 示例 中 CurrentLocationDemoActivity. java 文件 的 


完整 代码 


package edu.hrbeu.CurrentLocationDempy 


1 

2 

3 import android.app.Activity; 

4 import android.content.Context; 

5 import android.location.location; 

6 import android.location.IlocationListener; 
7 import android.location.LocationManager; 
8 import android.os.Burdle; 

9 import android.widget.TextView; 


1  pdblic class CurrentIocationDemomctivity extends Activity ( 

12 

13 GOverride 

14 public void onCreate (Bundle savedInstanceState) { 

15 Super .onCreate (savedInstanceState) ; 

16 setContentView (R. layout main) ; 

17 

18 String serviceString- Context.IOCATION SERVICE; 

19 LocationManager locationManager- (LocationManager)getSystemService 


(serviceString); 
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String provider-IocatiorManager.GPS PROVIDER; 
Location location- locationManager.getlastKnownLocation (provider) ; 


getLocationTnfo (location); 


locatiarenager.requestEocaticripdates (provider, 2000, 0, locaticnbistener); 


private void getlocationInfo (Location location) ( 


String latlongInfo; 
TextView locationText- (TextView) findViewById(R.id.label); 


if (location!- null) ( 
double lat- location.getlatitude () ; 
dable 1ng- location.getLongitude () ; 
latlongInfo- "Lat: "+ lat+ "AnLlong: "+ lng; 
) 
else( 
latlongInfo- "No location found"; 


locationText.setText ("Your Current Position is:\n"+ latLongInfo) ; 


private final locationListener locationListener- new LocationListener () { 


GOverride 
public void onlocationChanged (Location location) ( 
getlocationInfo (location); 


QOverride 
public void onProviderDisabled(String provider) { 
getlocationiInfo (null); 


QOverride 
public void onProviderEnabled (String provider) ( 
getIocationInfo (null); 
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B 


GOverride 
public void oanStatusChanged (String provider, int status, Bundle extras) { 


) 


IRATA 


92 Guoge 地 图 应 用 


开发 地 图 应 用 的 第 一 步 是 在 Google 网 站 上 申请 “地 图 密 钥 ”, 然 后 使 用 Android 系 
统 提 供 的 MapView 控件 显示 和 控制 Google 地 图 ,并 可 以 在 MapView 上 添加 覆盖 层 , 实 
现 地 图 表面 的 信息 显示 和 图 形 绘制 。 


921 申请 地 图 密 钥 


为 了 在 手机 中 更 直观 地 显示 地 理 信息 ,程序 开发 人 员 可 以 直接 使 用 Google 提供 的 
地 图 服务 ,实现 地 理 信 息 的 可 视 化 开发 。 只 要 使 用 MapView (com. google. android. 
maps. MapView) 就 可 以 将 Google 地 图 嵌入 到 Android 应 用 程序 中 。 但 在 使 用 
MapView 进行 开发 前 ,必须 向 Google 申请 经 过 验证 的 “地 图 密 钥 ”(Map API Key) ,这 样 
才能 正常 使 用 Google 的 地 图 服务 。“ 地 图 密 钥 "是 访问 Google 地 图 数据 的 密 钥 ,无 论 是 
模拟 器 还 是 在 真实 设备 中 都 需要 使 用 这 个 密 钥 。 

注册 “地 图 密 钥 ” 的 第 一 步 是 申请 一 个 Google 账户 ,也 就 是 Gmail 电子 邮箱 ,申请 地 
址 是 https://www. google. com/accounts/Login, 

在 得 到 Google 账户 之 后 ,下 一 步 工作 是 找到 保存 Debug 证 书 的 keystore 的 位 置 ,并 
获取 证 书 的 MD5 散 列 值 。keystore 是 一 个 密码 保护 的 文件 .用 来 存储 Android 的 证 书 ， 
获取 MD5 散 列 值 的 主要 目的 是 为 下 一 步 申 请 “地 图 密 钥 ” 做 准备 。 获 取 Debug 证 书 的 保 
存 位 置 的 方法 如 图 9. 3 所 示 ,首先 打开 Eclipse, 通 过 Window — Preferences 命令 打开 配 
置 窗 体 ,在 Android Build 栏 中 的 Default debug keystore 中 可 以 找到 。 

为 了 获取 Debug 证 书 MD5 散 列 值 ,需要 打开 命令 行 工 具 CMD, 然 后 切换 到 
keystore 的 目录 .输入 如 下 命令 。 


keytool - list - v - keystore debug.keystore 


Keytool 是 JDK 提供 的 工具 ,如 果 提 示 无 法 找到 keytool, 则 可 以 将 二 Java SDK>/ 
bin 的 路 径 添 加 到 系统 的 PATH 变量 中 。 在 提示 输入 keystore 密码 时 ,输入 密码 
android ,或 直接 输入 回 车 ,MD5、SHA1 和 SHA256 散 列 值 将 都 显示 出 来 。 如 图 9. 4 所 
示 , 笔 者 的 MD5 散 列 值 为 D4:8C:F8:29:A4:4F:57:D4:A8:F5:49:D9:9A:38:5A:F6。 

申请 “地 图 密 钥 ”的 最 后 一 步 是 打开 申请 页 面 .输入 MD5 散 列 值 。 申 请 页 面 的 地 址 


E Preferences 


gi General 
S Android 
DONS 
Launch 
LogCat 
Usage Stats 
B Ant 
由 Help 
E Install/Update 
由 Java 
四 Run/Debug 
由 Tasks 
E Tean 
E Usage Data Collector 
Validation 
由 -XML 
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Build 


Build Settings: 


[Z]Autonatically refresh Resources and Assets folder on build 


Build output 
Osilent 
O Moraal 
O Verbose 


Default debug keystore: [C:\Documents and Settings\warner\. android\debug. keystore | 


Ee 


Restore Defaults 


图 9.3 命令 运行 结果 


是 http://code. google. c 
html, 如 图 9.5 所 示 。 
输入 MD5 散 列 值 后 


图 9.4 获取 keystore 的 MD5 散 列 值 


om/intl/zh-CN/android/add-ons/google-apis/maps-api-signup. 


,点 击 Generate API Key 按钮 ,将 提示 用 户 输入 Google 账户 ,下 


确 输入 账户 后 ,将 生成 程序 开发 需要 使 用 的 “地 图 密 钥 ”, 如 图 9. 6 所 示 。 
笔者 获取 的 “地 图 密 钥 " 是 0mVK8GeO6 WUzmtzGfNoqXISKRW4oeh5lj VMoiCg ,在 


以 后 使 用 到 MapView 的 
Debug 证 书 的 MD5 散 列 


才 候 都 需要 输入 这 个 密 钥 。 但 需要 注意 的 是 ,读者 必须 根据 
值 ,自己 到 Google 网 站 上 申请 一 个 用 于 调试 程序 的 “地 图 密 


钥 ”, 而 不 能 使 用 上 面 笔者 申请 到 的 “地 图 密 钥 ”。 


922 使 用 Googe 地 


在 申请 到 “地 图 密 钥 


”后 ,下 面 应 考虑 如 何在 Android 系统 中 显示 和 控制 Google 地 


图 。MapView 是 地 图 的 显示 控件 ,可 以 设置 不 同 的 显示 模式 ,例如 卫星 模式 、 街 道 模式 
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Google Projects for Android: Google APIs Hans Dew Big Group 
Eun Maps API Key Signup 


Use tha form on this page to register with he Googie Macs senice and obtain a Maps AP! Key, Registration 
[ro Before you register, read Chi 


Gouing Started APLKaY to vncarctand row. AFI Key 
Whatis Googie APIs adi you are developing 5s usad n your Android appi yes 
a modod, and pow 10 generate an MDS fingerprint 


based cn youi develoger cercate. 


Inztsling hz Adan 

Maps ou regista, your Key wl ba associated with your Google Account 
Quei 
Obtaining a Maps 
Fr 


Mops API Kay Signup 
AELBatstencs 


Resources 
Android Delopers 
Guide» 


l. Your reletionshi with Googl 
V. Your ose of wy of the 


sid Wapa AFIs (refecrod to in this. 


E) U have reas and agree wen the terms and eonsions ale wersion) 
Mycenteows woste | 


图 9.5 获取 Map API Key 页 面 


您 的 密 钥 是 : 
OnmVK8GeD6NWUzmtzGfNoqXI5KRNW4oeh51]jVMoiCg 


此 密 钥 适用 于 所 有 使 用 以 下 指纹 所 对 应 证 书 进行 验证 的 应 用 程序 : 


D4 :8C:F8:29:4:4F:57:D4:A8:F5:49:D9:9A:38:5A:F6 
下 面 吓 一 个 XML 格式 的 示例 ， 帮 助 您 了 解 地 图 功能 。 


<com.google .android.maps.MapView 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:apiKey-"0mvK8GeOGWUzmtzGfNOQXISKRWA4Oeh51jVMoicg" 
/> 


9.6 “地 图 密 钥 " 获 取 结 果 


或 交通 模式 。 而 MapController 则 是 MapView 的 控制 器 ,可 以 控制 MapView 的 显示 中 
心 和 缩放 级 别 等 功能 。 

下 面 的 内 容 以 GoogleMapDemo 为 例 ,说明 如 何在 Android 系统 中 开发 Google 地 图 
程序 。 这 个 示例 将 在 程序 内 部 设置 一 个 坐标 点 ,然后 在 程序 启动 时 ,使 用 MapView 控件 
在 地 图 上 显示 这 个 坐标 点 的 位 置 。 

因为 普通 版 本 的 Android SDK 并 不 包含 Google 地 图 的 开发 扩展 库 ,因此 在 建立 工 
程 时 须 将 com. google. android. maps 扩展 库 添 加 到 工程 中 ,这 样 就 可 以 使 用 Google 地 图 
的 所 有 功能 。 添 加 com. google. android. maps 扩展 库 的 方式 是 在 创建 工程 时 ,在 Build 
Target 项 中 选择 Google APIs, 如 图 9.7 所 示 。 

创建 工程 后 ,修改 /res/layout/main. xml 文件 ,在 布局 中 加 入 一 个 MapView 12 fF. 
并 设置 刚 获取 的 “地 图 密 钥 >。main. xml 文件 的 完整 代码 如 下 。 


EWE ERJ SHEANA 
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48 New Android Project S] 
Select Build Target 
Choose an SDK to target 
Build Target 
Target Name Vendor Platform API ... 
Android 4.0 Android Open Source Project 40 14 
| | E Google apis Google Inc. 40 14 


Android + Google APIs 


Q9 «Bak [Net> | Fnish | [Gcencel 


Bl 9.7 引入 Google 地 图 扩展 库 


<?xml version- "1.0" encoding- "utf- 8"?» 
< LinearLayout. xmins:android- "http: //schemas.android.con/apk/res/android" 
android:orientation- "vertical" 
android:layout width- "fill parent" 
android:layout height- "fill parent"> 
< TextView android:layout width- "fill parent" 
android:layout height- "wrap content" 
android:text- "Gstring/hello"/» 


< aan.google.android.maps.MapView 

android:id- "@+ id/mapview" 

android:layout width= "fill parent" 

android:layout height= "fill parent" 

android:enabled- "true" 

android:clickable- "true" 

android:apiKey- "OnVK8GeO6WUzmtzGENoqKISKEW4osh51jVMPpicg"/> 
< /Linearlayout^ 


仅 在 布局 中 添加 MapView 控件 ,还 不 能 够 直接 在 程序 中 调用 这 个 控件 ,还 须要 将 程 
序 本 身 设 置 成 MapActivity Ccom. google. android. maps. MapActivity) . MapActivity 类 


负责 处 理 显 示 Google 地 图 所 需 的 生命 周期 和 后 台 服 务 管理 。 
下 面 给 出 GoogleMapDemoActivity. java 文件 的 完整 代码 。 


心 d pH 


package edu.hribpeu.GoogleMapDemo; 


import cam.google.android.maps.GeoPoint; 
import cam.google.android.maps.MapActivity; 
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5 import oam.google.android.maps.MapController; 

6 inport cam.google.android.maps.MapView; 

T 

8 inport amdmoid.os.Bundle; 

9 

10 public class GoogleMapDemoactivity extends Maphctivity { 
11 private MapView mapView; 

32 private MapController mapController; 

13 

14 GOverride 

15 public void onCreate (Bundle savedInstanceState) ( 
16 Super .onCreate (savedInstanceState) ; 

17 setContentView (R. layout .main) ; 

18 

19 mapView= (MapView) finaViewByTd(R. id.mapview) ; 
20 mapController- mapView.getController () ; 

21 

22 Double 1ng- 126.676530486 * 1E6; 

23 Double lat- 45.7698895661* 1E6; 

24 GeoPoint point- new GeoFoint (lat.intValue(), 1ng.intValue()); 
25 

26 mapController.setCenter (point) ; 

27 mapController.setzoom(11) ; 

28 mapController.animateTo (point) ; 

29 

30 mapView.setSatellite (false); 

3 ) 

a 

33 GOverride 

3 protected boolean isRouteDisplayed() ( 

35 //TOD Auto- generated method stub 

36 return false; 

3] } 

38 } 


代码 第 20 行 获取 了 MapController, 用 以 在 第 26 行 设 置 MapView 的 “预订 显示 中 
点 ”, 在 第 27 行 设置 缩放 层级 ,在 第 28 行将 MapView 的 实际 显示 中 心 移动 到 第 26 £pi 
置 的 “预订 显示 中 心 ”。 代 码 第 22 行 和 第 23 行 设置 地 理 坐 标点 的 经 度 为 126. 676530486 
* 1E6、 纬 度 为 45. 7698895661 * 1E6。 但 在 代码 第 26 行 ,没有 直接 使 用 这 个 坐标 ,而 是 
将 其 转化 为 GeoPoint 再 使 用 。 代 码 第 30 行 是 设 定 MapView 的 地 图 显示 模式 是 否 为 卫 
星 模式 ,设置 true 则 为 卫星 模式 ,设置 false 则 为 普通 模式 。 代码 第 34 行 
isRouteDisplayed() 方 法 ,是 用 来 通知 程序 是 否 在 Google 地 图 中 显示 路 径 信 息 ,默认 为 不 
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显示 。 

运行 前 还 需要 在 AndroidManifest. xml 文件 中 添加 地 图 库 文件 的 引用 说 明 ( 下 面 代 
码 第 21 行 ) 和 人 允许 访问 互联 网 的 许可 (下 面 代码 第 8 行 ), 原 因 是 获取 Google 地 图 是 需要 
使 用 互联 网 的 。 

AndroidManifest. xml 文件 的 完整 代码 如 下 。 


1 <?xml version- "1.0" encoding- "utf- 8"?» 

2 «manifest xmlns:android- "http: //schemas .android.can/apk/res/android" 
3 package- "edu.hrbeu.GoogleMapDen" 

4 android:versionCode- "1" 

5 android:versionName- "1.0" > 

6 

3 < uses- sdk android:minSdkVersion- "14"/» 

8 < uses- permission android:name- "android.permi ssion. INTERNET" /»- 
9 

10 «application 

1l android:icon- "Gdrawable/ic launcher" 

12 android:label- "Gstring/app name" > 

13 «activity 

14 android: label= "@string/app_name" 

15 android:name= " .GoogleMapDemoacti vity" > 

16 < intent- filter > 

17 < action android:name- "android.intent.action.MAIN"/» 
18 < category android:name- "android. intent category. LAUNCHER" /> 
19 < /intent- filter» 

20 < /activity> 

2 < uses- library android:name= "om.google.android.maps"/> 

22 < /agplication» 

23  «/manifest^ 


最 后 ,程序 运行 时 需要 连接 互联 网 ,运行 结果 如 图 9. 8 所 示 。 
923 地 图 上 使 用 覆盖 层 


在 很 多 的 地 图 应 用 中 都 须要 在 地 图 上 显示 信息 或 绘制 图 形 。 通 过 在 MapView 上 添 
加 覆盖 层 ,可 以 在 指定 的 位 置 添加 注解 、 绘 制图 像 或 处 理 鼠 标 事件 等 。Google 地 图 上 可 
以 加 入 多 个 覆盖 层 ,所 有 覆盖 层 均 在 地 图 图 层 之 上 ,每 个 覆盖 层 均 可 以 对 用 户 的 点 击 事 
件 作出 响应 。 

创建 覆盖 层 继承 Overlay 类 的 子 类 ,并 通过 重 载 draw() 方 法 为 指定 位 置 添 加 注解 ， 
重 载 onTap() 方 法 处 理 用 户 的 点 击 操作 。 

下 面 的 代码 是 创建 Overlay 的 最 小 代码 集合 。 
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E sooolevappemo 


Hulan 


Harbin 
Daoviai 


gag Mene 
GD 


Pingfáng 


(a) 地 图 模式 (b) 卫星 模式 
图 9.8  GoogleMapDemo 示例 运行 结果 


1 public class TextOverlay extends Overlay ( 

2 GOverride 

3 public void draw(Canvas canvas, MapView mapView, boolean shadow) ( 
4 if (shadow- - false) { 

5 

6 ) 

7 else{ 

8 } 

9 Super.draw (canvas, mapView, shadow); 

10 } 

u 

12 GOverride 

33 public boolean onTap(GeoPoint p, MapView mapView) ( 
14 return false; 

15 $ 

16 } 


在 代码 第 3 行 的 draw O Jr i& P» shadow 变量 是 用 来 区 分 绘制 不 同 的 图 层 , 如 果 
shadow 为 false, 则 表示 在 覆盖 层 上 进行 绘制 ,反之 则 表示 在 隐藏 层 上 进行 绘制 。 代 码 的 
第 14 行 是 onTap() 方 法 的 返回 值 , 返 回 false 表示 覆盖 层 不 处 理 点 击 事件 ,返回 true W) 
表示 已 经 处 理 了 点 击 事件 。 

在 覆盖 层 绘 制图 形 或 文字 需要 使 用 “画布 "(canvas) 来 实现 ,绘制 的 位 置 是 屏幕 坐标 ， 
这 就 需要 将 地 图 上 的 物理 坐标 与 屏幕 坐标 进行 转换 。Projection 类 提供 了 物理 坐标 和 屏 
幕 坐 标的 转换 功能 ,可 在 经 度 和 纬度 表示 的 GeoPoint 点 和 屏幕 上 Point 点 进行 转换 。 其 
中 ,toPixels() 方 法 将 物理 坐标 转换 为 屏幕 坐标 ,fromPixels() 方 法 将 屏幕 坐标 转换 为 物 
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理 坐标 ,具体 使 用 方法 可 以 参考 下 面 的 代码 : 


Projection projection- mapView.getProjection|() ; 


projection.toPixels (geoPoint, point); 
projection.fromPixels (point.x, point.y); 


下 面 的 内 容 用 MapOverlayDemo 示例 说 明 如 何在 Google 地 图 上 添加 覆盖 层 , 并 在 
预订 的 物理 坐标 上 显示 提示 信息 。MapOverlayDemo 示例 的 运行 结果 如 图 9. 9 所 示 。 


Hulan 


Harbin 
boone IER 


ENangan 
GD 


Pingfáng 
Act 


9.9 MapOverlayDemo 运行 结果 


TextOverlay 类 是 MapOverlayDemo 示例 的 覆盖 层 ,主要 重 载 了 draw() 方 法 ,在 指 
定 的 物理 坐标 上 绘制 了 标记 点 和 提示 文字 。 
TextOverlay. java 文件 的 核心 代码 如 下 。 


1 public class TextOverlay extends Overlay ( 

2 private final int mRadius- 5; 

3 

4 &Override 

5 public void draw(Canvas canvas, MapView mapView, boolean shadow) ( 
6 Projection projection- mapView.getProjection|(); 

1 

8 if (shadow- - false)( 

9 Double 1ng- 126.676530486 + 1E6; 

10 Double lat- 45.7698895661* 1E6; 

1l GeoPoint geoPoint- new GeoFoint (lat.intValue(), 1ng.intValue()); 
12 

13 Point point- new Point () ; 
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14 projection.toPixels (geoPoint, point); 

15 

16 RectF oval- new RectF (point.x —mRadius, point.y - nRadius, point. x+ mRadius, 
point.y* nFadius) ; 

17 

18 Paint paint- new Paint () ; 

19 paint.setARGB(250, 250, 0, 0); 

20 paint.setAntiAlias (true); 

21 paint.setFakeBoldText (true) ; 

22 

23 canvas.drawOval (oval, paint); 

24 canvas .drawText ("bj it. Mi ", point.x*2* mRadius, point.y, paint); 

25 ) 

26 super.draw (canvas, mapView, shadow); 

27 ) 

28 

29 GOverride 

30 public boolean onTap(GecPoint p, MapView mapView) ( 

3 return false; 

32 ) 

3 } 


代码 第 2 行 声明 了 绘制 半径 变量 mRadius ,用 来 定义 绘制 范围 使 用 ;代码 第 14 行使 
用 toPixels() 方 法 完成 从 物理 坐标 到 屏幕 坐标 的 转换 ;第 19 行 设置 了 绘制 颜色 ;第 20 行 
开启 了 平滑 设置 ,防止 文字 出 现 锯齿 ;代码 第 23 行 绘制 了 圆 形 的 标记 点 ,标记 点 的 大 小 
以 代码 第 16 行 设 定 的 oval 为 准 ; 代 码 第 24 行 绘制 了 提示 文字 ,第 2 个 和 第 3 个 参数 是 


绘制 屏幕 的 x 坐标 和 y 坐标 。 
建立 了 覆盖 层 后 ,还 需要 把 覆盖 层 添 加 到 MapView 上 。MapOverlayDemoActivity. 

java 的 核心 代码 如 下 。 

1 public class MaboverlayDemactivity extends Maphctivity ( 

2 private MapView mapView; 

3 private MapController mapController; 

4 private TextOverlay textOverlay; 

5 

6 QOverride 

8 Super.onCreate (savedInstanceState) ; 

9 setContentView(R.layout.main); 

10 

n mepView- (MapView) findViewByTd (R. id.mapview) ; 

12 mapController- mapView.getController () ; 
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13 

14 Double 1ng- 126.676530486 * 1E6; 

15 Double lat- 45.7698895661* 1E6; 

16 GeoPoint point- new GeoPoint (lat.intValue(), lng.intValue()); 

17 

18 mapController.setCanter (point) ; 

19 mapController.setZoam(11) ; 

20 mepController.animateTo (point) ; 

21 

22 textOverlay- new TextOverlay () ; 

23 List« Overlay» overlays- mapView.getOverlays () ; 

24 overlays.add (textOverlay) ; 

253 } 

26 

27 GOverride 

28 protected boolean isRouteDisplayed() { 

29 return false; 

30 ) 

X3 ] 

代码 第 22 行 实例 化 了 TextOverlay 对 象 ;在 第 23 行 通过 getOverlays() 方 法 ,获取 

MapView 已 有 的 覆盖 层 ;在 第 24 行使 用 add() 方 法 将 TextOverlay 对 象 添加 到 


MapView 中 。 
j ER 
1. 讨论 位 置 服务 和 地 图 应 用 的 发 展 前 景 。 


2. 编程 实现 轨迹 追踪 软件 。 每 间隔 60 秒 ,同时 距离 移动 大 于 1 米 的 情况 下 ,记录 一 
次 位 置信 息 ,在 Google 地 图 上 绘制 600 秒 的 行动 轨迹 。 


Widget 组 件 开发 


Widget 是 一 种 可 被 嵌入 到 其 他 程序 的 视图 ,并 可 周期 性 进行 更 新 。 随 着 Android 平 
板 电 脑 和 其 他 大 屏幕 设备 的 出 现 , Widget 越 来 越 广泛 地 用 于 开发 主屏 幕 的 信息 显示 程 
序 。 通 过 本 章 的 学 习 , 读 者 可 以 了 解 Widget 的 概念 特征 和 用 途 , 并 掌握 其 具体 的 开发 
方法 和 配置 方法 。 

本 章 学 习 目标 : 

* 了 解 Widget 的 概念 及 特征 ; 

。 掌握 Widget 的 设计 原则 和 开发 步骤 ; 

* 了 解 Widget 的 调试 方法 ; 

。 掌握 使 用 Activity 配置 Widget 的 方法 ; 

。 掌握 使 用 Service 更 新 Widget 的 方法 。 


101 Wdes 简介 


Widget 是 一 个 具有 特定 功能 的 视图 ,一般 被 嵌入 到 主屏 幕 (home screen) tH ,用户 在 
不 启动 任何 程序 的 前 提 下 ,就 可 以 在 主屏 幕 上 直接 浏览 Widget 所 显示 的 信息 。Widget 
在 主屏 幕 上 显示 自 定义 的 界面 布局 ,在 后 台 周 期 性 地 更 新 数据 信息 ,并 根据 这 些 更 新 的 
数据 修改 主屏 幕 的 显示 内 容 。Widget 可 以 有 效 地 利用 手机 的 屏幕 ,快捷 、 方 便 地 浏览 信 
息 ,为 用 户 带 来 良好 的 交互 体验 。 

Widget 是 Android 1. 5 引入 的 新 特性 发展 到 Android 4. 0 已 经 有 很 大 的 进步 和 改 
变 , 例 如 在 Android 3. 1 引入 的 更 改 Widget 尺寸 功能 ,以 及 Android 4. 0 增加 的 自动 设 
置 边 界 功能 。Widget 在 主屏 幕 上 可 以 出 现 多 个 相同 的 副本 ,也 可 以 根据 用 户 的 设置 , 产 
生 尺寸 布局 \ 刷 新 速率 和 更 新 逻辑 完全 不 同 的 副本 。 将 Widget 程序 设计 成 多 个 界面 风 
格 的 版 本 ,有 助 于 适应 不 同 用 户 的 喜好 。 

目前 , Widget 在 Android 智能 手机 和 平板 电脑 上 具有 非常 广泛 的 应 用 ,包括 用 
Widget 实现 的 微 博客 .RSS 订阅 器 、 股 市 信息 、 天 气 预 报 \ 日 历 、 时 钟 \, 信 息 提醒 ,电量 显 
示 、 邮 件 、 便 签 、 音 乐 播放 、 相 册 和 新 闻 等 ,如 图 10. 1 所 示 。 

在 Android 4. 0 系统 中 , 自 带 了 多 个 Widget 程序 ,包括 时 钟 .书签 .音乐 播放 器 .相框 
和 搜索 栏 等 ,如 图 10. 2 所 示 。 在 Widget 列表 中 可 以 查看 所 有 的 Widget 组 件 ,通过 长 时 
间 点 击 Widget 组 件 , 可 以 将 Widget 组 件 添加 到 主屏 幕 上 。 
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Widgets 


S HTC Likes 


不 定 ? 那 就 用 抛 硬币 小 插件 来 
决定 吧 。 先 点 按 硬币 ， 然 后 
RERI) (REH! 》 电 话 即 可 抛 
硬币 了 。 
版 本 : 2.60 


BIRS 。 WLAN ”自动 同步 


图 10.1 各 种 Widget 图 10.2 Android 4.0 中 的 Widget 


102 Widget 基础 


Widget 基础 包括 Widget 的 设计 原则 、 开 发 步骤 和 调试 过 程 。Widget 设计 原则 介绍 
Widget 界面 布局 的 设计 要 求 ,Widget 开发 步骤 将 以 Se 为 例 介 绍 Widget 的 
- 般 开 发 流程 , Widget 调试 过 程 将 介绍 Widget 的 安装 、 加 载 和 删除 方法 。 


1021 设计 原则 


Widget 是 主屏 幕 上 的 显示 元 素 , 不 仅 自 身 具 有 一 定 的 设计 规则 ,还 要 与 主屏 幕 上 其 
他 的 元 素 保 持 美观 一 致 。 

Widget 显示 在 主屏 幕 上 的 结构 如 图 10. 3 所 Masi bia da 
示 。 最 外 层 是 单元 格 边界 ,这 个 边界 是 不 同 Widget rE m 
的 分 隔 界限 ,在 界面 上 这 个 界限 对 用 户 是 不 可 见 的 。 1 
框架 边界 是 Widget 背景 图 像 的 界限 , 青 景 略 像 全 车 | | | “| 
EN 个 框架 (frame) 。 最 里 面 是 Widget Controls. 

这 是 显示 Widget 界面 元 素 的 空间 。 

Widget Padding 是 框架 边界 与 Widget 单元 格 边界 ”框架 边界 

Controls 之 间 的 距离 ,可 将 Widget 的 界面 元 素 显 示 图 10.3 Widget 构成 


在 背景 图 片 的 中 间 区 域 。 

为 了 保证 多 个 Widget 显示 时 不 会 靠 得 太 近 , 一 般 都 会 设 定 Widget Margins, 这 个 值 
是 单元 格 边界 与 框架 边界 的 距离 。 如 果 Widget Margins 的 值 为 0, 则 两 个 Widget 就 会 
连 在 一 起 。 在 Android 4. 0 中 ,系统 会 自动 添加 Margins ,保持 两 个 Widget 间隔 一 定 的 
距离 。 笔 者 建议 使 用 这 个 新 功能 ,方法 是 只 要 将 AndroidManifest. xml 文件 中 的 
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targetSdkVersion 设置 为 14。 

下 面 介 绍 如 何 设计 同时 适应 Android 4. 0 以 及 较 早 Android 系统 的 Widget 界面 布 
局 ,使 之 在 较 早 的 Android 系统 上 具有 自 定义 的 Widget Margins 值 ,而 在 Android 4. 0 
上 保持 相同 的 显示 方式 ,而 不 会 因为 Android 4. 0 自动 添加 边界 间隔 而 导致 显示 不 一 臻 
的 情况 。 具 体 方法 如 下 。 

(D 首先 ,将 AndroidManifest. xml 文件 中 的 targetSdkVersion 设置 为 14。 

(2) 建立 布局 文件 ,引用 dimension 资源 ,布局 文件 如 下 。 


< Framelayout 
android:layout width- "match parent" 
android:layout height- "match parent" 
android:layout margine "édimen/widget margin"» 


< Linearlayout 
android:layout width- "match parent" 
android:layout height- "match parent" 
android:orientation- "horizontal" 

10 android:background- "édrawable/widget background" 

a < /Linearlayout^ 

12  «/Framelayout? 


1 
2 
3 
4 
5 
6 
7 
8 
9 


(3) 建立 两 个 dimension 资源 ,第 1 个 在 /res/values 目录 下 ,为 较 早 的 Android 系统 
提供 自 定义 的 Margins; 第 2 个 在 /res/values-v14 目录 下 ,为 Android 4. 0 系统 设 定 
Margins。 


res/values/ dimens. xml: 


< dimen name= "widget margin"> 15dp< /dimen> 


res/ values-v14/dimens. xml: 


< dimen name- "widget margin" 0dp« /dimen» 


Android 系统 将 主屏 幕 划分 为 单元 格 ,单元 格 的 大 小 和 数量 会 随 设备 的 变化 而 完全 
不 同 ,一 般 智 能 手机 会 被 划分 为 4X4 的 单元 格 ,而 平板 电脑 一 般 会 被 划分 为 8X7 的 单 
元 格 。 当 用 户 将 Widget 加 入 到 主屏 幕 时 ,Widget 会 占据 一 定数 量 的 单元 格 ,占据 单元 格 
的 数量 由 minWidth 和 minHeight 决定 ,这 两 个 属性 是 默认 情况 下 Widget 的 显示 尺寸 ， 
具体 的 计算 方法 可 以 查看 表 10. 1。 其 中 ,dp 表示 与 设备 无 关 的 像素 ,计算 公式 中 之 所 以 
要 减 去 30, 是 为 了 防止 像素 计算 时 的 整数 会 人 导致 错误 。 


sz Waget 组 件 开发 245 


表 10.1 Widget 尺寸 与 单元 格 数量 的 对 应 关系 


idget R5 = Widget R7 i 
Ms MR 单元 格 数量 mets ads 单元 格 数量 
40dp 1 250dp 4 
110dp 2 i i 
180dp 3 70 * n—30 n 


在 设 定 minWidth 和 minHeight 时 ,最 基本 的 原则 是 使 Widget 处 于 最 佳 的 显示 状 
态 。 下 面 以 “音乐 播放 器 ”为 例 说 明 如 何 计算 Widget 的 minWidth 和 minHeight 值 。 音 
乐 播放 器 的 界面 如 图 10.4 所 示 。 
音乐 播放 器 由 一 个 显示 歌曲 信息 的 TextView 和 两 个 控制 音乐 播放 的 按钮 组 成 。 音 
乐 播放 器 的 界面 元 素 尺寸 如 图 10. 5 所 示 。minWidth 应 等 于 三 个 控件 的 宽度 和 ,加 上 控 
件 之 间 的 空隙 ,minHeight 应 等 于 TextView 控件 的 高 度 加 上 边界 空隙 。 具 体 的 计算 方 
法 可 以 参考 下 面 的 公式 : 
minWidth = 144dp + (2 X 8dp) + (2 x 56dp) = 272dp 
minHeight = 48dp + (2 X 4dp) = 56dp 


8dp 4dp 8dp 

S| The song title... »» pyl 
The song title... » o» “| SongArtist a 
Song Artist 144dp 56dp . 
图 10.4 音乐 播放 器 的 界面 图 10.5 音乐 播放 器 的 界面 元 素 尺寸 


为 了 增加 Widget 对 不 同 屏幕 尺寸 和 单元 格 尺寸 的 适应 性 ,建议 尽量 使 用 具有 自 适 
应 能 力 的 布局 ,例如 线性 布局 .相对 布局 或 框架 布局 。 而 且 在 设计 界面 元 素 时 ,将 不 可 改 
变 尺 寸 的 界面 元 素 的 高 度 和 宽度 设置 成 固定 值 , 而 让 尺寸 可 改变 的 界面 元 素 填 充 全 部 剩 
余 空间 。 例 如 ,在 音乐 播放 器 的 界面 中 ,将 两 个 按钮 的 尺寸 固定 ;TextView 的 宽度 设置 
为 可 变 的 ,并 允许 TextView 在 横向 上 占据 所 有 可 用 的 空间 ;为 了 美观 ,TextView 的 高 度 
应 该 固定 。 最 后 ,应 该 保证 所 有 界面 元 素 在 纵向 上 居中 显示 。 

当 Widget 的 尺寸 不 够 填充 满 所 应 占 的 单元 格 时 ,Widget 会 在 横向 和 纵向 拉 伸 ,以 填 
充 所 有 应 该 占据 的 单元 格 。 图 10. 6 是 音乐 播放 器 在 单元 格 尺 寸 为 80dp X 100dp. 
Margins 为 16 的 显示 效果 。 

最 后 ,建议 读者 使 用 NinePatche 文件 作为 背景 图 像 ,文件 扩展 名 为 . 9. png。 这 种 图 
像 文件 可 以 自动 填充 整个 背景 空间 ,同时 不 会 影响 界面 的 美观 。 

读者 可 以 在 下 面 的 地 址 下 载 Widget 模板 包 , 模 板 包 中 包括 NinePatch 图 像 文件 、 
XML 文件 和 Photoshop 源 文件 等 内 容 , 适 用 于 不 同 屏幕 分 辨 率 和 Android 版 本 系统 ,如 
图 10.7 所 示 。 下 载 地 址 为 http://developer. android. com/shareables/app | widget _ 
templates-v4. 0. zip。 
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CA 2 版 ) 


The song ttem ful » o» |] . B 


图 10.6 音乐 播放 器 在 80dpX 100dp 图 10.7 Widget 模板 包 
单元 格 中 的 显示 效果 


1022 开发 步骤 


在 介绍 了 Widget 的 基础 框架 类 后 ,简单 说 明 Widget 的 一 般 开 发 步骤 如 下 : 

(1) 设计 Widget 的 布局 ; 

(2) 定义 Widget 的 元 数据 ; 

(3) 实现 Widget 的 添加 、 删 除 、 更 新 ; 

(4) 在 AnroidManifest. xml 文件 中 声明 Widget。 

下 面 以 SimpleWidget 为 例 , 介 绍 Widget 的 开发 步骤 ,以 及 Widget 框架 类 中 各 个 函 
数 的 调用 顺序 。 


1. 设计 Widget 的 布局 


创建 Widget 的 第 一 步 是 设计 并 实现 Widget 的 组 件 布局 ,就 是 Widget 和 用 户 交 互 
的 界面 。SimpleWidget 示例 的 设计 目标 如 
图 10. 8 所 示 ,背景 使 用 Ni nePatch 的 PNG. 图 | TextView 所 占用 的 空间 为 浅 蓝 色 区 域 e) 
片 ,内 部 为 白色 背景 .具有 浅 蓝 色 的 边框 。 
Widget 内 部 包含 TextView 和 ImageButton 控 图 10.8 SimpleWidget 示例 的 设计 目标 
件 ,使 用 线性 水 平 布 局 。 

Widget 与 Activity 的 布局 设计 和 实现 方法 十 分 相似 ,都 是 在 /res/layout 目录 中 建 
立 基于 XML 的 布局 资源 文件 。SimpleWidget 示例 建立 的 Widget 布局 文件 的 文件 名 为 
widget layout. xml, 将 Widget 背景 图 片 放置 在 /res/drawable 目录 中 ,文件 名 为 widget | 
background. 9. png。 

下 面 给 出 widget_layout. xml 的 完整 代码 。 


< ?xml version= "1.0" encoding- "utf- 8"?> 
< Linearlayout xmlns:android- "http://schemas.android.comapk/res/android" 
android:layout width- "fill parent" 
android:layout height- "fill parent" 
android:orientation- "horizontal" 
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6 android:background- "@drawable/widget. background" 
7 android:pacding- "8dp"> 

8 

9 « TextView android:id- "@+ id/label" 

10 android:layout width- "wrap content" 

1 android:layout height= "48dp" 

2 android:text- "TextView 所 占用 的 空间 为 浅 蓝 色 区 域 " 
i3 android:textColor- "(color/black" 

14 android:background- "à color/lightskyblue" 

15 ardroid:layout weight- "1" 

16 android:layout gravity- "center vertical"/» 
17 

18 < ImageButton 

19 android:id- "@+ id/image button" 

20 android:layout width- "48dp" 

2 android: layout_height= "48dp" 

2 android:src- "@drawable/button image" 

23. android:layout gravity- "center vertical"/» 
24 

25  «/Linearlayout^ 


代码 第 13 行将 TextView 的 字体 颜色 设置 为 黑色 ,代码 第 14 行将 TextView 的 背 
景 颜色 设置 为 浅 蓝 色 ,主要 用 来 确定 TextView 所 占据 的 区 域 范围 。 代 码 第 15 行将 
layout_weight 设 为 1, 而 没有 在 ImageButton 中 设置 这 个 参数 .表明 TextView 控件 会 占 
据 父 节点 所 拥有 的 剩余 空间 。 

在 Eclipse 的 界面 设计 器 中 ,Widget 的 显示 效果 与 设计 目标 略 有 区 别 , 如 图 10. 9 所 


Editing config: default [enviocae s) [Android 0 ~] [ce 
zimwvGA(NemwsOne v]Perrat ~]Normal [Daytime [eme — m E 
| palette = |a (EET) &&&|aa 


m mE 


TexiVewFt 5 EESS GI S ARE k ) 


Cj Text Fields 
D Layouts 

L composite 

C Images & Media 
L Time & Date 


O Transitions 
J Advanced 
C other L 


Custom & Library Views | 


图 10.9 界面 设计 器 中 的 显示 效果 
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示 ,主要 原因 是 线性 布局 的 layout_width 和 layout_height 属性 都 被 设置 成 fill_parent。 

出 于 Widget 的 安全 和 性 能 考虑 , Widget 支持 的 布局 和 控件 存在 一 些 限 制 。 目 前 
Widget 支持 的 布局 有 框架 布局 .线性 布局 和 相对 布局 ;支持 的 界面 控件 有 AnalogClock 、 
Button, Chronometer, ImageButton, ImageView, ProgressBar, TextView, ViewFlipper, 
ListView,GridView ,StatckView 和 AdapterViewFlipper, 


2. 定义 Widget 的 元 数据 


Widget 元 数据 定义 了 Widget 最 基本 的 信息 ,包括 Widget 的 尺寸 .更 新 周期 .布局 文 
件 位 置 、 预 览 图 片 、 拉 伸 方 向 和 配置 界面 等 。 

SimpleWidget 示例 的 Widget 元 数据 文件 保存 在 /res/xml/widget_template. xml, 该 
文件 的 完整 代码 如 下 。 


1 <?xml version- "1.0" encoding- "utf- 8"?» 

2 — «appwidget- provider 

3 smins:android- "http://schemas.andiroid.oon/apk/res/android" 
4 android:mirWidth- "1503p" 

5  android:minteight- "60dp" 

6 android:resizeMode- "horizontal | vertical" 

7 android:minResizeHeight= "80dp" 

8 android:minResizeWidth- "48dp" 

9 android:updatePeriodMillis- "36000" 

10  android:initiallayout- "élayout/widget layout" 
ll —android:previewImage- "Gdrawable/preview" 

122 ^ 


代码 第 2 行使 用 appwidget-provider 标签 声明 了 Widget 的 元 数据 。 代 码 第 4 (3:81 
第 5 行 定 义 了 Widget 的 两 个 关键 属性 ,minWidth 和 minHeight 分 别 表示 默认 情况 下 
Widget 的 显示 宽度 和 高 度 , 也 就 是 Widget 在 拖 中 到 主屏 幕 时 的 尺寸 。 

Android 3. 1 以 后 的 系统 支持 改变 Widget 的 显示 尺寸 ,代码 第 6 行 声 明 Widget 的 
尺寸 可 以 改变 ,horizontal| vertical 表示 在 水 平和 垂直 方向 上 的 大 小 都 是 可 以 变化 的 。 其 
中 ,不 可 调整 ,水 平方 向 调整 .垂直 方向 调整 ,水 平 与 垂直 方向 调整 ,这 4 种 方式 的 参数 分 
别 为 none,horizontal, vertical, horizontal] vertical, 

在 代码 第 7 行 和 第 8 行 中 ,Widget 的 最 小 尺寸 由 minResizeWidth 和 minResizeHeight 
决定 。minResizeHeight 是 Widget 能 够 重新 设置 的 最 小 高 度 , 此 值 在 大 于 minHeight 
时 ,或 resizeMode 中 不 支持 垂直 (vertical) 拖 中 时 ,该 属性 不 起 作用 。minResizeWidth 是 
Widget 能 够 重新 设置 的 最 小 宽度 ,此 值 在 超过 minWidth 时 ,或 者 resizeMode 不 支持 水 
平 (horizontal) 拖 中 时 ,该 属性 不 起 作用 。 

代码 第 9 行 的 updatePeriodMillis 表示 以 毫秒 为 单位 的 更 新 周期 .Android 会 以 这 个 
速率 唤醒 设备 以 便 更 新 Widget, 开 发 人 员 应 尽 可 能 地 降低 设备 被 唤醒 的 次 数 ,以 降低 设 
备 的 能 量 消耗 。 当 更 新 周期 小 于 30 分 钟 时 ,Android 系统 并 不 按照 此 参数 更 新 Widget. 
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如 果 需 要 频繁 更 新 Widget, 可 以 在 Service 服务 中 
实现 。 

代码 第 10 行 的 initialLayout 用 来 指定 Widget 
的 布局 。 代 码 第 11 行 的 previewImage 定义 了 在 
Android 系统 Widget 列表 中 预览 图 像 。 如 果 不 设置 
该 值 , 则 以 程序 的 图 标 作为 预览 图 像 。SimpleWidget 
示例 的 预览 图 像 如 图 10. 10 所 示 。 


Æ 10.10 SimpleWidget 示例 的 预览 图 像 
3. 实现 Widget 的 添加 、 删 除 .更 新 


实现 Widget 的 添加 删除 .更 新 等 过 程 ,主要 是 通过 AppWidgetProvider 类 来 实现 。 
这 个 类 本 身 继承 BroadcastReceiver, 用 来 接收 与 Widget 相关 的 更 新 .删除 .生效 和 失效 
等 消息 。 当 AppWidgetProvider 接收 这 些 消 息 后 ,会 分 别 调用 相应 的 事件 处 理 函 数 , 如 
表 10. 2 所 示 。 


表 10.2 AppWidgetProvider 类 的 事件 处 理 函 数 


事 件 调用 函数 说 明 
ACTION_APPWIDGET_UPDATE Widget 更 新 
ACTION_APPWIDGET_DELETED Widget 删除 
ACTION_APPWIDGET BLED Widget 生效 
ACTION_APPWIDGET_DISABLED Widget 失效 


onUpdate() 


onDelete() 


onDisabled() 


在 SimpleWidget 示例 中 , WidgetProvider 继承 AppWidgetProvider 类 ,在 Widget 
更 新 .删除 等 操作 过 程 中 调用 其 内 部 的 函数 。WidgetProvider. java 文件 的 完整 代码 
如 下 。 


package edu.hrbeu.SimpleWidget; 


1 

3 inport android.arpwidget..AppitidgetManager; 
4  ámport android.appwidget.Appiti get Provider; 
5  ámport android.content Context; 
6 import android.util.Iog; 

3 

8 

9 


public class WidgetProvider extends AppWidgetProvider { 
private static final String TAG- "WIDGET"; 


n GOverride 

12 public void onUpdate (Context context, AppWidgetManager appWidgetManager, int [] 
appiidgetIds) { 

13 Log.d (T2, "onüpdate") ; 

14 ] 
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16 GOverride 

5 püblic void onDeleted (Context context, int[] appWidgetIds) { 
18 Icg.d(TAG, "onDeleted") ; 

19 ) 

20 

2 GOverride 

2 public void onEnabled (Context. context) ( 
2 Log.d(TAG, "onEnabled"); 

24 ) 

25 

26 GOverride 

2] public void onDisabled(Context context) ( 
28 Log.d(TAG, "onDisabled"); 

29 ) 

3 } 


从 代码 中 不 难 发 现 ,虽然 重 载 了 onUpdate O , onDelete O) , onEnabled €) 和 onDis- 
abled() 四 个 函数 ,但 仅 在 函数 中 设置 了 调试 信息 ,后 期 可 以 利用 调试 信息 观察 这 些 函 数 
何 时 会 被 调用 。 

onUpdate(Context, AppWidgetManager, int[ ]) 函数 在 updatePeriodMillis 定义 时 
间 间 隔 到 期 时 被 调用 ,主要 用 来 更 新 Widget 组 件 的 界面 显示 。 除 此 以 外 ,在 用 户 每 次 将 
Widget 拖 忠 到 主屏 幕 时 ,该 函数 也 会 被 调用 ,可 在 此 函数 中 为 界面 元 素 定义 按钮 点 击 事 
件 处 理 函数 ,或 者 启动 一 个 临时 的 Service 进行 数据 获取 等 。 

onDeleted(Context context. int[ ] appWidgetlds) 函 数 是 当 一 个 Widget 从 主屏 幕 上 
被 删除 时 调用 的 函数 ,用 来 回收 资源 。 

onEnabled(Context context) 函数 在 首 个 Widget 实例 被 创建 并 添加 到 主屏 幕 时 被 调 
用 。Widget 可 以 在 主屏 幕 上 创建 多 个 实例 ,但 只 有 第 一 个 Widget 实例 被 创建 时 才 调 用 
该 函数 。onEnabled() 一 般 用 来 进行 一 些 初始 化 工作 ,例如 打开 一 个 新 的 数据 库 , 或 者 执 
行 对 所 有 Widget 实例 来 说 只 要 进行 一 次 的 设置 。 

onDisabled(Context context) 函数 在 最 后 一 个 Widget 实例 被 删除 时 调用 ,用 来 释放 
在 onEnabled() 中 使 用 的 资源 ,如 删除 在 onEnabled() 函 数 中 创建 的 临时 数据 库 。 

将 Widget 添加 到 主屏 幕 上 ,或 者 从 主屏 幕 删除 Widget 都 会 引发 AppWidgetProvider 中 
的 事件 处 理 函 数 。 以 SimpleWidget 为 示例 ,通过 观察 Eclipse 中 LogCat 的 输出 信息 ,分 
析 用 户 对 Widget 进行 不 同 操作 所 引发 的 事件 处 理 函数 ,以 及 其 调用 顺序 关系 。 

当 Widget 第 一 次 添加 到 主屏 幕 时 ,系统 会 按 顺 序 调用 onEnable() 和 onUpdate()。 
当 再 次 向 主屏 幕 添加 Widget 时 ,系统 则 仅 调用 onUpdate()。 当 从 主屏 幕 删除 Widget 
时 ,如 果 主 屏幕 还 有 这 个 Widget 的 实例 , 则 系统 仅 调用 onDelete O ;如果 被 删除 的 是 这 
个 Widget 的 最 后 一 个 实例 , 则 系统 在 调用 onDelete() 后 会 调用 onDisable() 。 
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4. 在 AnroidManifest, xml 文件 中 声明 Widget 


最 后 ,要 让 Widget 生效 还 须 在 AnroidManifest. xml 文件 中 进行 声明 ,主要 在 该 文件 
中 声明 AppWidgetProvider 2$, AnroidManifest. xml 的 完整 代码 如 下 。 


1 <?xml version- "1.0" encoding- "utf- 8"?» 

2 «manifest xmlns:android- "http://schemas .android.cam/apk/res/android" 
3 package "edu.hrbeu.SimpleWidget" 

4 android:versionCode- "1" 

9 android:versionName- "1.0" > 

6 

7 < uses- sdk android:minSdkVersion- "14"/» 

8 

9 « application 

10 android:icon- "Gdrawable/ic launcher" 

1 android:label- "Gstring/app name" > 

12 < receiver android:name- " .WidgetProvider"» 

13 <meta- data android:name- "android.appwidget.provider" 
14 android: resource= "G:ml/widget template"/» 

15 < intent- filter» 

16 «acticn android:nare- "android agpwicpet .acticn APPWIDEET UEDE"/> 
17 < /intent- filter> 

18 < /receiver» 

19 < /application» 

20  «/manifest^ 


代码 第 12 行 声 明了 receiver 标签 ,android:name 属性 定义 了 AppWidgetProvider 
的 子 类 。 代 码 第 13 ff meta-data 标签 中 的 android:name 属性 ,使 用 android. appwidget. 
provider 表示 这 里 的 数据 是 Widget 的 元 数据 。 代 码 第 14 行 的 android:resource 属性 声 
明了 元 数据 的 资源 路 径 。 代 码 第 15 行 定 义 了 intent-filter 标签 ,代码 第 16 行 声 明 接 收 
ACTION_APPWIDGET_UPDATE 消息 。 


1023 调试 过 程 


在 完成 SimpleWidget 示例 的 所 有 代码 后 ,进入 Widget 的 调试 过 程 。 在 进行 Widget 调 
试 前 ,首先 介绍 如 何 安 装 、 加 载 和 删除 Widget 组 件 。 

安装 Widget 与 安装 其 他 程序 相似 ,是 通过 
Eclipse 上 的 “运行 "(Run) 按 钮 启动 程序 的 编译 、 连 
接 、 打 包 和 安装 过 程 ,唯一 区 别 是 在 Widget 安装 到 
模拟 器 后 ,不 会 直接 出 现在 主屏 幕 上 .而 需要 用 户 在 
Android 系统 的 Widget 列表 中 手动 将 Widget 添加 
到 主屏 幕 上 。Android 系统 的 Widget 列表 如 
图 10. 11 Biz. 图 10. 11. Android 系统 的 Widget 列表 
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用 户 通过 长 时 间 ( 超 过 2 秒 ) 点 击 SimpleWidget 的 预览 图 标 ,将 SimpleWidget 实例 
加 载 到 主屏 幕 上 ,默认 情况 下 占据 3X1 个 单元 格 ,如 图 10. 12(a) 所 示 。 


TextView 所 占用 的 空间 为 
浅 蓝 色 区 域 €) 
> E : 


(a) 初始 尺寸 (b) 拉 伸 效果 
10.12 SimpleWidget 示例 效果 图 


在 主屏 幕 上 ,通过 长 时 间 点 击 SimpleWidget 实例 ,可 以 调整 Widget 的 尺寸 ,如 
图 10. 12(b) 所 示 , Widget 边缘 出 现 4 个 实心 菱形 。 通 过 拖 电 这 些 实心 萎 形 ,可 以 调整 
Widget 的 尺寸 。SimpleWidget 实例 在 图 10. 12(b) 中 占据 了 4X2 个 单元 格 。 

添加 第 二 个 SimpleWidget 实例 的 过 程 与 添加 第 一 个 SimpleWidget 实例 的 过 程 完 全 
一 致 


在 希望 删除 Widget 时 ,同样 是 通过 长 时 间 点 击 主屏 幕 上 的 Widget 实例 ,主屏 幕 上 

会 出 现 垃圾 桶 ,直接 将 Widget 实例 拖 到 垃圾 桶 即 可 。 需 要 注意 的 是 主屏 幕 上 的 垃圾 
桶 是 隐藏 的 ,需要 通过 长 时 间 点 击 Widget 示例 才 会 出 现 。 当 Widget 实例 在 垃圾 桶 上 方 
呈现 出 红色 时 , 松 开 手 指 便 可 完成 删除 操作 。 


103 Wig 配置 


在 Widget 的 使 用 过 程 中 ,有 时 用 户 需要 根据 个 人 喜好 设置 Widget 的 不 同 特征 ,如 
Widget 的 外 观 风格 .字体 颜色 .字体 大 小 .更 新 时 间或 背景 图 案 等 。 比 较 普遍 的 做 法 是 在 
Widget 添加 到 主屏 幕 时 ,启动 一 个 用 于 配置 Widget 的 Activity, 用 户 在 这 个 Activity 中 
设 定 Widget 的 特征 。 

配置 Widget 特征 的 Activity, 需 要 在 Widget 元 数据 XML 文件 中 进行 声明 ,声明 的 
属性 为 android:configure, 其 值 为 Activity 所 在 的 类 ,示例 代码 如 下 。 
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<?xml version- "1.0" encoding- "utf- 8"?> 
< appwidget- provider 
xmins:android- "http: //schemas.android.oaapk/res/android" 
android:configure- "edu.hrbeu.ConfigWidget .ConfigActivity" 
> 


o 0c QI PP 


在 代码 第 5 frr , Activity 使 用 了 带 命名 空间 (edu. hrbeu. ConfigWidget) 的 声明 方 
式 ,这 是 因为 调用 Activity 的 Widget 宿主 与 Activity 并 不 在 相同 的 命名 空间 中 。 

元 数据 中 声明 的 Activity, 在 每 个 Widget 实例 被 添加 到 主屏 幕 前 会 被 启动 。 当 用 户 
完成 配置 选择 关闭 Activity, Widget 才 会 出 现在 主屏 幕 上 。 

用 户 配 置 Widget 的 Activity 也 需要 在 AndroidManifest. xml 文件 中 声明 。 不 同 于 
声明 普通 的 Activity. ix ff Activity 是 被 Widget 的 宿主 通过 发 送 android. appwidget. 
action. APPWIDGET_CONFIGURE 动作 启动 的 ,所 以 此 Activity 需要 接收 Intent il 
EB ,示例 代码 如 下 。 


1 «activity android:name- ".Configactivity"> 
2 < intent- filter» 

3 < action android:name= "andoid.appwi det „action .APEWIDEET CCNETRLEE"'/^ 
4 < /intent- filter> 

5 < /activity> 


当 用 户 使 用 Activity 完成 Widget 的 配置 后 ,Activity 有 责任 调用 相应 代码 对 Widget 进 
行 更 新 , Activity 可 以 直接 调用 AppWidgetManager 类 更 新 Widget, 也 可 调用 开发 人 员 在 
AppWidgetProvider 中 编写 的 静态 更 新 函数 ,实现 Widget 的 更 新 。AppWidgetManager 
负责 管理 Widget 的 类 ,向 AppWidgetProvider 发 送 通 知 。 

要 实现 使 用 Activity 配置 Widget 特征 ,并 在 适当 的 时 候 更 新 Widget, 可 以 参考 如 下 
DI M 


1. 获取 Widget 的 ID 


Widget 的 宿主 在 启动 Activity 时 ,将 Widget 的 ID 保存 在 Intent 中 ,通过 调用 
extras. getInt O 函数, 获取 Widget 的 ID. 

extras. getInt(String key. int defaultValue) 函数 中 ,参数 1 是 获取 数据 的 关键 字 ,应 
使 用 关键 字 appWidgetId, 或 AppWidgetManager. EXTRA. APPWIDGET ID; £3 2 是 
无 法 获取 数据 时 函数 返回 的 代替 数据 ,示例 代码 如 下 。 


Intent intent- getIntent () ; 

Bundle extras- intent .getExtras () ; 

if(extras!- null) ( 
mAppWidgetId- extras.getInt ( AgoWidgetManager.EXTRA APPWIDGET ID, AppWidgetManager. 
INVALID APEWIDCET ID); 
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} 
if(mppWidgetId-- AppWidgetManager.INVALID APPWIDGET ID) { 
finish(); 


5 
6 
T 
8 


} 


代码 第 4 行 的 AppWidgetManager. INVALID_APPWIDGET_ID 的 值 为 0, 表示 没 
有 获取 Widget 的 ID。 代码 第 6 行 和 第 7 行 说 明 , 在 没有 正确 获取 Widget 的 ID 时 ,可 以 
立即 关闭 Activity, 因 为 没有 正确 的 ID, 即 使 完成 配置 工作 ,也 无 法 将 配置 信息 正确 传递 
回 Widget, 


2. 配置 Widget 


这 个 过 程 用 户 会 在 界面 上 选择 相应 的 配置 方案 和 配置 信息 ,并 最 终 通 过 事件 引发 更 
新 Widget 过 程 , 并 关闭 Activity。 


3. 更 新 Widget 


在 更 新 Widget 时 ,首先 通过 调用 getInstance(context) 函数 获取 AppWidgetManager 实 
例 , 然 后 建立 一 个 RemoteViews, 在 这 个 RemoteViews 上 更 改 Widget 的 界面 元 素 , 最 后 调用 
updateAppWidget(int, views) K% SE Widget 更 新 。RemoteViews 是 可 在 其 他 进程 中 显示 
的 视图 类 ,提供 对 部 分 界面 控件 的 最 基本 的 操作 。 示 例 代 码 如 下 。 


AppWidgetManager appWidgetManager- MEWidogetManager.getInstance (context) ; 
FemoteViews views- new RemoteViews (context .getPackageName () ,R.layout.widget layout); 
views.setTextColor (R.id.label,textColor); 

appWidgetManager .updateAppWidget (appWidgetId, views); 


X 


代码 第 2 行 的 R. layout. widget layout 是 Widget 的 布局 。 代 码 第 3 行 set TextColor O 
函数 可 以 设置 TextView 控件 的 字体 颜色 ,TextView 控件 的 ID H R. id. label,textColor 是 代 
表 颜 色 的 Int 型 整数 。 代 码 第 4 行 的 updateAppWidget() 函数 中 ,参数 1 是 Widget 的 ID. 
数 2 是 刚 建 立 的 RemoteViews。 


4. 设置 返回 信息 ,并 关闭 Activity 


通过 调用 setResult(int resultCode. Intent data) 函数 ,设置 Activity 的 返回 代码 和 
返回 数据 。 返 回 代码 应 为 RESULT_OK 或 RESULT CANCELED, RESULT OK X 
IR Widget 设置 成 功 , Widget 宿主 会 将 Widget 实例 加 载 到 主屏 幕 上 ;如 果 返 回 的 是 
RESULT_CANCELED, Widget 宿主 则 取消 Widget 实例 的 加 载 过 程 , Widget 也 不 会 出 
现在 主屏 幕 上 。 返 回 数据 应 包含 Widget 的 ID, 并 使 用 AppWidgetManager. EXTRA _ 
APPWIDGET ID 作为 关键 字 ,示例 代码 如 下 。 
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Intent resultValue- new Intent () ; 

resultValue.putExtra (AppWidgetManager.EXTRA APEWIDGET ID, mAppWidgetld); 
setResult (RESULT CK, resultValue); 

finish(); 


S WNE 


这 里 需要 注意 的 是 ,需要 处 理 用 户 在 未 完成 Widget 配置 前 ,通过 回 退 键 离开 
Activity 的 情况 ,方法 非常 简单 ,只 要 在 Activity 的 onCreateO 函数 开始 处 添加 如 下 代码 
即 可 。 


public void onCreate (Bundle icicle) ( 
setResult (RESULT CANCELED); 


) 


在 未 正确 完成 Widget 配置 前 ,如 果 用 户 离开 
Activity 配置 界面 ,Activity 的 返回 代码 则 是 RESULT 
_CANCELED。 

ConfigWidget 示例 中 提供 了 完整 的 代码 ,说 明 如 
何在 Activity 中 选择 Widget 中 TextView 的 字体 颜 
色 。ConfigWidget 示例 是 在 SimpleWidget 示例 代码 
的 基础 上 进行 的 修改 和 添加 ,部 分 代码 的 理解 可 以 参 图 10.13 ConfigWidget 示例 Widget 
考 SimpleWidget 示例 代码 的 说 明 。ConfigWidget 示例 配置 界面 
的 Widget 配置 界面 如 图 10. 13 所 示 。 
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在 Widget 中 如 果 需 要 进行 频繁 更 新 ,一 般 采用 Service 周期 性 地 更 新 Widget 的 方 
ik. Widget 元 数据 中 的 updatePeriodMillis 属性 是 无 法 进行 频繁 更 新 的 ,对 于 低 于 30 分 

钟 的 设 定 值 ,该 属性 并 不 生效 。 
当 进 行 Widget 更 新 时 ,如 果 在 onUpdateO 函数 中 代码 运行 时 间 超 过 5 秒 钟 ,例如 进 
行 网 络 操作 、 复 杂 运 算 等 , 则 会 产生 应 用 程序 无 响应 (Application Not Responding. ANR) 
错误 。 使 用 Service 更 新 Widget 可 以 避免 这 种 问题 的 出 现 , 将 比较 耗 时 的 代码 在 Service 

中 实现 .然后 直接 在 Service 中 更 新 Widget 的 界面 。 
下 面 以 ServiceWidget 为 例 , 说 明 如 何 使 用 Service 
e 更 新 Widget, ServiceWidget 示例 的 用 户 界 面 如 图 10. 14 
I 所 示 。 

10. 14  ServiceWidget 示例 ServiceWidget 示例 在 AppWidgetProvider 中 启动 
的 用 户 界面 Service. 当 最 后 一 个 Widget 实例 在 主屏 幕 上 被 删除 时 停 
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止 这 个 Service。Service 在 启动 后 会 开启 一 个 工作 线程 ,线程 每 2 秒 钟 产生 一 个 随机 小 
数 , 并 将 这 个 随机 小 数 显 示 在 Widget 的 界面 上 。 
首先 给 出 Service 的 核心 代码 : 


1 override 

2 public void rn() { 

3 while(!Thread.interrupted()){ 

4 double randcmDouble= Math. random () ; 

5 String msg= String.valueOf (randomDouble) ; 
6 WidgetProvider.updateAppWidget (this, msg) ; 
7 

8 uyt 

9 "Ihread.sleep (2000) ; 

10 ) catch (InterruptedException e) ( 

11 e.printStackTrace () ; 

2 ) 

13 ) 

14 } 


代码 第 6 行 调用 了 WidgetProvider 中 的 静态 函数 updateAppWidget() ,进行 Widget 
界面 更 新 。 

WidgetProvider 类 继承 AppWidgetProvider, 其 中 的 公有 静态 函数 updateAppWidget() 
的 代码 如 下 : 


1 private static Queue« Integer» widgetlIds- new LinkedList« Integer» (); 

2 

3 public static void updateAppWidget (Context. context, String displayMsg ) { 

4 AppWidgetManager appilidgetManager- AppidgetManager.getInstance 
(context) ; 

5 RempteViews views- newRembteViews (context .getPackageName () ,R. layout. 
widget layout); 

6 views.setTextViewText (R.id.label, displayMsg); 

1 

8 final int N- widgetIds.size(); 

9 for(int i-0; i<N; i++) ( 

10 int appWidgetId- widgetIds.poll.(); 

1 apgpiidgetManager .updateAppWidget (appWidgetId, views); 

12 widœtIds.add (appidget Ta) ; 

B } 

14 $ 


updateAppWidget O 函数 每 2 秒 被 执行 一 次 ,负责 所 有 Widget 实例 的 更 新 。 代 码 第 
1 行 定 义 了 一 个 队列 widgetIds, 用 于 保存 所 有 Widget 实例 的 ID 值 。 代 码 第 8 行 获取 
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Widget 实例 的 数量 ,并 在 代码 第 11 行 实现 Widget 的 更 新 操作 。 代 码 第 10 行 和 第 12 行 
分 别 实现 队列 数据 的 取出 和 加 入 ,主要 目的 是 为 了 遍历 队列 中 所 有 Widget 的 ID 值 。 
更 新 所 有 Widget 实例 需要 Widget 的 ID 值 , 因 此 在 WidgetProvider 类 onUpdate() 
函数 中 须 将 新 建 Widget 的 ID 值 添加 到 widgetIds 队列 中 ,并 在 onDeleted O RZP M s 
被 移 除 Widget 的 ID 值 。 
WidgetProvider 类 onUpdate() 函数 的 代码 如 下 。 


1 override 
2 public void on0pdate (Context context, AppWidgetManager appWidgetManager, int [] 
appWidgetIds)( 
Iog.d(TAG, "orUpdate") ; 


3 

4 

5 for(int i- 0 ;i< appitidgetIds.length; i++){ 

6 widgetIds.acd (arpWidgetIds[1]) ; 

1 Icg.d(7G," wicretTd:" e agpiictet Tas [i]+ ", Size: e widget Tde.size ); 
8 ) 

9 


10 Log.d(TAG, "appiidgetIds.length:"4 appiidgetIds.length); 
11 context.startServioe (new Intent (context, TRandamService.class)); 
E ) 


代码 第 11 行 调 用 startService O 函数 ,启动 TRandomService 服务 。 虽 然 比较 优雅 
的 方法 是 在 onEnable() 函数 中 调用 startService O 函数 启动 服务 ,但 在 Widget 实际 运行 
过 程 中 ,偶然 会 出 现 服务 没有 启动 , 却 不 是 首次 添加 Widget 的 情况 。 如 果 将 启动 服务 的 
代码 放 在 onEnable() 函 数 中 ,此 时 将 无 法 启动 服务 ,Widget 也 无 法 进行 更 新 。 

在 onUpdate() 函 数 中 启动 服务 ,会 导致 服务 被 多 次 启动 ,如 果 不 进 行 控制 ,服务 会 开 
启 多 个 线程 ,频繁 更 新 Widget。 因 此 ,TRandomService 类 声明 一 个 布尔 值 threadRunning. 
表示 是 否 已 经 有 工作 线程 在 运行 ,并 在 onStart() 函 数 中 进行 判断 。 

TRandomService 类 onStart() 函 数 的 代码 如 下 。 


GOverride 
public void onStart (Intent intent, int startId) { 
super.onStart (intent, startId); 
‘Tast maket (this, "(2) 调用 onStart() :" , Test.IENGIH SHRI) .show(); 
if(IthreadRumning) ( 
threadRunning- true; 
new Thread (this) .start () 
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} 


WidgetProvider 类 onDeleted O 函数 负责 将 Widget 的 ID 从 widgetIds 队列 中 删除 ， 
首先 判断 ID 值 是 否 在 队列 中 ,如 果 在 , 则 删除 。 
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WidgetProvider 类 onDeleted O 函数 的 代码 如 下 。 


» GOverride 

2 public void onDeleted(Context context, int[] apWidgtIds) { 

3 Log.d(T2G, "onDeleted"); 

4 for(int i-0; i< apiWidgetIds.length ;i++){ 

5 if (widgetIds.contains (appWidgetIds [1]) ) ( 

6 widgetIds.remove ( (Object)appWidgetIds [1]) 7 

3 ) 

8 Iocg.d (TAG," widgetIds:"4 appWidgetIds[i]* ", Size:"+ widgetIds. 
size); 

9 ) 

10 Log.d(TAG, "appiticgetIds. length:"* appWidgetIds. length) ; 

u ) 


在 最 后 一 个 Widget 从 主屏 幕 上 被 删除 后 ,此 时 则 没有 必要 让 服务 继续 运行 ,因此 在 
onDisabled() 函 数 中 调用 stopService() 函 数 来 停止 服务 。 
WidgetProvider 类 onDisabled O 函数 的 代码 如 下 。 


1 GOverride 

2 public void onDisabled(Context context) ( 

3 log.d(TAG, "onDisabled"); 

4 context.stopService (new Intent (context, TRandamService.class)); 
5 ) 


3 题 


1. 分 析 Widget 的 优势 和 不 足 。 
2. 简 述 Widget 的 设计 原则 和 注意 事项 。 
3. 尝试 开发 显示 电量 信息 或 短信 内 容 的 Widget. 
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Android NDK 开发 


Android NDK 4& Android 平台 能 够 使 用 本 地 代码 (C 和 C++ ) 开 发 应 用 程序 ,不 仅 
可 以 提高 关键 模块 的 执行 效率 ,还 有 利于 重用 已 有 的 C 或 C++ 代码 ,对 于 Android 系统 
的 普及 具有 深远 的 意义 。 通 过 本 章 的 学 习 可 以 让 读者 初步 了 解 Android NDK 的 使 用 和 
开发 方法 。 

本 章 学 习 目 标 : 

* 了解 Android NDK 的 用 途 和 不 足 ; 

* 掌握 Android NDK 编译 环境 的 安装 与 配置 方法 ; 

。 掌握 Android NDK 的 开发 步骤 ; 

。 了解 动态 检测 CPU 类 型 的 方法 。 


111  NOK fi 4i 


Android NDK( Android Native Development Kit) 是 一 系列 的 开发 工具 ,人 允许 程序 开 
发 人 员 在 Android 应 用 程序 中 嵌入 C 或 C++ 语言 编写 的 本 地 代码 。 

一 般 情况 下 ,Android 程序 使 用 Java 语言 在 Android 应 用 程序 框架 下 进行 开发 , 编 
译 后 产生 的 托管 代码 在 Dalvik 虚拟 机 上 运行 。 但 在 一 些 使 用 Android 应 用 程序 框架 无 
法 满足 运行 效率 的 地 方 ,程序 开发 人 员 和 希望 能 够 使 用 本 地 代码 开发 应 用 程序 的 核心 部 
分 ,以 提高 程序 核心 模块 的 运行 效率 。 不 仅 如 此 ,程序 开发 人 员 还 希望 能 够 直接 使 用 已 
有 成 熟 的 C/C++ 源 代 码 ,提高 Android 程序 的 开发 速度 。Android NDK 的 出 现 , 不 仅 解 
决 了 核心 模块 使 用 托管 语言 开发 执行 效率 低下 的 问题 ,还 允许 直接 使 用 C/C++ 源 代码 ， 
极 大 地 提高 了 Android 应 用 程序 开发 的 灵活 性 。 

当然 ,程序 开发 人 员 不 能 只 看 到 使 用 Android NDK 开发 所 带 来 的 好 处 ,还 必须 清楚 
认识 到 什么 情况 下 才 适 合 使 用 Android NDK, Android NDK 并 不 会 自动 提升 所 有 
Android 程序 的 执行 效率 ,但 一 定 会 增加 程序 的 复杂 程度 和 调试 难度 ,因此 程序 开发 人 员 
需要 仔细 权衡 Android NDK 所 能 提升 的 运行 效率 与 增加 的 复杂 程度 是 否 在 可 接受 的 范 
围 内 。 因 此 选择 使 用 Android NDK 应 主要 出 于 以 下 两 种 目的 : 一 是 Android 应 用 程序 
框架 无 法 满足 运行 效率 时 ;二 是 需要 使 用 大 量 已 有 C/C++ 源 代码 时 。 

Android NDK 提供 一 系列 的 工具 ,编译 文件 .文档 和 示例 代码 ,用 于 从 C/C++ 源 代 
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码 中 生成 本 地 代码 库 ,还 提供 了 将 本 地 代码 库 嵌 入 到 apk 文件 的 方法 。Android NDK 所 
包含 大 量 的 本 地 系统 头 文件 和 库 文件 ,主要 是 用 来 支持 未 来 版 本 的 Android 系统 。 
Android NDK 所 支持 的 最 低 版 本 Android 系统 是 1.5 版 本 ,如 果 使 用 本 地 Activity, 则 所 
需要 的 最 低 Android 系统 版 本 为 2.3 版 本 。 

最 新 版 本 的 Android NDK 支持 ARM 指令 集 , 包 括 ARMv5TE、ARMv7-A 和 x86。 
ARMv5TE 机 器 码 可 以 在 所 有 基于 ARM 的 Android 设备 上 使 用 ,ARMv7-A 机 器 码 则 
只 能 运行 在 具有 ARM7 CPU 的 Android 设备 上 ,如 Verizon Droid 手机 和 Google Nexus 
One 手 机 。ARMv7-A 与 ARMvSTE 指令 集 的 差别 主要 在 于 ,ARMYv7-A 支持 硬件 FPU 
( 浮 点 运算 单元 ) Thumb-2 和 NEON 指令 集 。 程 序 开发 人 员 可 以 针对 不 同 目标 设备 ,在 
Android NDK 中 使 用 不 同 的 ARM 指令 集 支 持 不 同 的 架构 ,也 可 以 同时 将 支持 多 个 架构 
的 指令 集 编 译 到 同一 个 apk 文件 中 。 


112. NK 和 开发 环境 


NDK 开发 环境 包括 Eclipse, Android NDK fill Cygwin, Eclipse 用 于 建立 Android T. 
程 和 编写 程序 代码 ,Android NDK 提供 编译 脚本 和 工具 ,Cygwin 完成 Linux 环境 下 的 交 
又 编译 ,将 C/C ++ 的 源 代码 文件 编译 成 Android 系统 可 调用 的 共享 连接 库 文件 。 
Eclipse 就 不 再 介绍 了 ,下 面 主要 介绍 Android NDK 和 Cygwin 的 安装 方法 。 

Android NDK 编译 环境 支持 Windows XP, Linux 和 MacOS, 本 书 仅 介 绍 Windows 
系统 的 编译 环境 配置 方法 。 首先 ,需要 到 Google 的 Android 开发 者 网 站 下 载 Android 
NDK 的 安装 包 , 下 载 地 址 是 http://developer. android. com/sdk/ndk/index. html. 下载 
页 面 如 图 11. 1 所 示 。 笔 者 下 载 的 Android NDK 是 针对 Windows 版 本 的 ,下 载 的 文件 为 
android-ndk-r6b-windows. zip。 将 下 载 的 ZIP 文件 解压 缩 到 用 户 的 Android 开发 目录 
中 ,笔者 将 Android NDK 解压 到 G:\Android 目录 中 ,ZIP 文件 中 包含 一 层 目 录 ,因此 
Android NDK 的 最 终 路 径 为 G:\Android\android-ndk-r6b。 


Download the Android NDK 


The Android NDK is a companion tool to the Android SDK that lets you build performance-critical portions of your apps in native code. It 
provides hoadors and libraries that allow you to build activities, handlo user input, use hardwaro sensors, access application rosourcos, and 
more, when programming in C or C++. If you write native code, your applications are still packaged into an .apk file and they still run inside of 
a virtual machine on the device The fundamental Android application model does not change 

Using native code does not result in an automatic performance increase, but always increases application complexity. If you have not run into 
any limitations using the Android framework APIs, you probably do not need the NDK. Read What is the NDK? for more information about 
what the NDK offers and whether it will be useful to you. 


Tho NDK is dosignod for uso only in conjunction with tho Android SDK. If you have not alroady installod and setup tho Android SDK, ploaso 
do so before downloading the NDK. 
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Windows android-ndk-r6b-windows zip. 67670219 bytes t496b481IT06341303de1708081b812. 
MacOSX (inte) android-ndk-r6b-darwin-x66 tarbz2 52798843 byles 65f2589ac1b08aabe31839ed1a8ce8e 


Linux 32/64-bit (x86) android-ndk-r6b-inux-x86.tar.bz2 46532436 byles 309135e49b64313cfb20ac428df4cec2 


A 11.1 Android NDK 下 载 页 面 
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第 二 步 是 下 载 并 安装 Cygwin。 目 前 ,Android NDK 还 不 支持 在 Windows 系统 下 直 
接 进 行 交 叉 编 译 , 因 此 需要 在 Windows 系统 中 安装 Linux 的 模拟 环境 Cygwin, 完 成 C/C++ 
代码 的 交叉 编译 工作 。Android NDK 要 求 Cygwin 的 版 本 高 于 1.7, 因 此 最 好 安装 较 新 
版 本 的 Cygwin。Cygwin 的 最 新 版 本 可 以 到 官方 网 站 http://www. cygwin. com 下 载 。 
在 Cygwin 的 安装 过 程 中 ,需要 将 Devel 下 的 gcc 和 make 的 相关 选项 选 上 , 如 
图 11. 2 所 示 ,否则 Cygwin 将 无 法 编译 C/C++ 源 代 码 文件 。 


~ Cygwin Setup — Select Packages 


Okeep OBev. Olmi OE (View) caeom 
Size Package 


Current Ner 


3.4, 4-999 他 3.4.4-3 
他 Skip 

3.4.4-999 全 Keep 

3.4.4-999 43.4.43 
Skip 
Skip 
@skip 
skip 


lk gcc: C compiler upgrade helper 
6, TOBk gcc-ada: Ada compiler 

3,630k gec-core: C compiler 

2,958k gec-ght: CH compiler 

1,806k gec-gIT: Fortran compiler 
2,181k. gec-gdc: D compiler 

2,426k gec-gpc: GNU Pascal compiler 


11, 731k gcc-java: Java compiler 


34333343034340 
43330083% 0ļn 


« 
[7] Hide obsolete packages 


11.2. Cygwin 安装 选项 
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在 介绍 NDK 开发 前 ,首先 熟悉 一 下 Android NDK 为 程序 开发 人 员 提 供 的 资料 和 示 
例 。Android NDK 的 目录 中 包含 7 个 子 目 录 和 7 CE)build 
个 文件 ,结构 如 图 11. 3 所 示 。 Aa 
其 中 ,build 目录 保存 了 编译 脚本 和 配置 文件 。 | (+) platforms 
docs 目录 是 帮助 文档 目录 ,帮助 文档 的 名 称 和 用 途 | (十 )samples 
参考 表 11. 1。platforms 是 保存 了 编译 过 程 中 可 能 COsourees 
用 到 的 头 文件 和 库 文 件 ,并 根据 Android 版 本 和 | CSS 
CPU 类 型 进行 了 分 类 。sources 目录 中 保留 了 程序 ( —Yaocumisatation; itmi 
中 可 能 用 到 的 C/C++ 源 代码 文件 .CPU 类 型 检查 | (o GNUmakefile 
和 本 地 Activity 的 C/C++ 源 代码 文件 就 在 这 个 目 | (一 )ndk 一 build 
录 中 。tests 是 测试 代码 目录 ,toolchains 是 交叉 编 | (一 )ndk 一 gdb 
译 工具 目录 。 (一 )ndk 一 statck. exe 
documentation. html 是 帮助 文档 的 起 始 页 ， abi pé. "^ 
可 以 通过 该 文件 快速 浏览 docs 目录 中 的 所 有 帮 
助 文档 。GNUmakefile 是 编译 配置 文件 。ndk- 图 11.3 Android NDK 的 目录 和 结构 


(+ )toolchains 
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build 是 交叉 编译 的 快捷 脚本 。ndk-gdb 用 于 Debug 调试 的 脚本 。README. txt 和 
RELEASE. txt 分 别 是 Android NDK 的 说 明文 档 和 版 本 信息 。 


表 11.1 


文件 名 


docs 目录 中 的 帮助 文件 说 明 
说 明 


OVERVIEW. html 


Android NDK 的 概括 性 说 明 , 包 括 NDK 的 目标 、 适 用 范围 、 
开发 步骤 和 NDK 关键 配置 文件 的 简要 说 明 等 


INSTALL. html 


NDK 的 安装 与 配置 说 明文 档 


DEVELOPMENT. html 


说 明 如 何 对 NDK 进行 修改 ,以 及 如 何 发 布 新 的 实验 性 
NDK 包 


HOWTO. html 


关于 NDK 通用 性 问题 的 说 明 


ANDROID-MK. html 


说 明 构 建 Android. mk 文件 的 语法 格式 。Android. mk 定义 
了 模块 的 编译 信息 ,包括 模块 (module) 名 称 、 与 C/C++ 源 代 
码 文 件 的 对 应 关系 


APPLICATION-MK. html 


说 明 构 建 Application. mk 文件 的 语法 格式 。Application. mk 
定义 了 应 用 程序 的 编译 信息 ,包括 CPU 体系 类 型 .模块 列表 、 
编译 器 的 参数 等 


CPU-ARCH-ABIS. html 


处 理 器 ABIS( 应 用 程序 二 进 制 接口 ) 说 明文 档 


CPU-ARM-NEON. html 


ARM 处 理 器 NEON 扩展 指令 集 说 明文 档 


CPU-FEATURES. html 


处 理 器 类 型 和 指令 集 特征 的 检查 说 明文 档 


IMPORT-MODULE. html 


说 明 如 何在 Android. mk 中 引用 其 他 模块 ,以 及 建立 引用 模 
块 的 方法 


NDK-BUILD. html 


如 何 使 用 ndk-build 脚本 进行 编译 


NDK-GDB. html 


如 何 使 用 ndk-gdb 脚本 进行 本 地 调试 


PREBUILTS. html 


如 何 制作 预 编译 库 文件 


STABLE-APIS. html 


支持 的 稳定 的 API 类 表 


STANDALONE-TOOLCHAIN. html 


如 何 将 NDK 提供 的 交叉 编译 工具 作为 独立 的 编译 器 使 用 


system/libc/OVERVIEW. html 


Bionic C 库 的 简介 


system/libc/SYSV-IPC. html 


介绍 NDK 不 支持 system v 进程 间 通 信 的 原因 


system/libc/CHANGES. html 


不 同 版 本 下 Bionic 的 区 别 


CHANGES. html 


不 同 版 本 NDK 的 区 别 


SYSTEM-ISSUES. html 


NDK 开发 所 需要 注意 的 问题 


LICENSES. html 


NDK 的 使 用 许可 


samples 目录 是 为 程序 开发 人 员 提供 的 Android NDK 开发 示例 ,示例 的 详细 信息 可 


参考 表 11. 2。 


ERIS Anod NDK 开 发 
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3 11.2 samples 目录 中 的 NDK 开发 示例 


示 例 说 明 


con 非常 简单 的 NDK 示例 ,使 用 共享 库 调 用 本 地 函数 获取 一 个 字符 种, 然后 显示 在 用 
: 户 界面 上 

稍微 复杂 一 些 的 示例 ,程序 中 有 两 个 库 , 一 个 静态 库 和 一 个 动态 库 。 静 态 库 实现 了 

two-libs 简单 的 加 法 运算 ,动态 库 则 调用 了 静态 库 中 的 加 法 函数 ,并 进行 了 重新 封装 。 应 用 


程序 则 动态 加 载 这 个 动态 共享 库 , 然 后 调用 重新 封装 后 的 加 法 函数 


当 使 用 GLSurfaceView 对 象 管理 Activity 的 生命 周期 时 ,使 用 本 地 的 OpenGL ES 
APIs ii 3e 3D 图 像 


san-angeles 


hello-gl2 使 用 OpenGL ES 2. 0 的 顶点 和 片段 着 色 器 泻 染 三 角形 


演示 如 何在 运行 时 通过 使 用 cpufeatures 库 检 测 CPU 的 类 型 ,如 果 CPU 支持 
NEON 指令 集 , 则 尝试 使 用 NEON 指令 集 


hello-neon 


bitmap-plasma | 说 明 如 何 通 过 本 地 代码 访问 Android 的 Bitmap 像素 缓冲 


native-activity | 说 明 如 何 使 用 静态 库 native-app-glue 建立 本 地 的 Activity 


native-plasma 通过 本 地 Activity 实现 的 bitmap-plasma 示例 


Android NDK 中 的 hello-jni 示例 是 最 简单 的 入 门 实例 ,程序 开发 人 员 可 以 通过 这 个 
示例 了 解 NDK 开发 的 基本 方法 。two-libs 示例 侧重 说 明 如 何在 动态 库 中 使 用 静态 库 。 
ep 示例 重点 说 明 如 何 为 不 同 CPU 编译 具有 针对 性 的 优化 代码 ,其余 的 示例 主要 

绍 与 图 像 相关 的 本 地 代码 开发 。 
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在 进行 NDK 开发 时 ,一 般 先 要 建立 Android 工程 ,在 Android 工程 中 创建 存放 
C/C++ 代码 的 jni 目录 。 然 后 在 Cygwin 环境 中 编译 C/C++ 代码 , NDK 的 编译 脚本 会 
在 Android 工程 中 自动 建立 libs 目录 ,将 编译 后 形成 的 共享 库 文件 保存 在 libs 目录 中 。 
最 后 ,在 编译 Android 工程 时 , libs 中 的 共享 库 文件 会 被 打包 到 apk 文件 中 ,保证 
Android 程序 可 以 正常 运行 。 

下 面 的 内 容 以 AndroidNdkDemo 为 例 来 说 明 如 何 进 行 Android NDK 开发 。 
AndroidNdkDemo 是 一 个 加 法 运算 的 示例 ,程序 会 随机 生成 两 个 整数 ,然后 调用 C 语言 
开发 的 共享 库 对 这 两 个 整数 进行 加 法 运算 ,最 后 将 运 
算 结 果 显 示 在 用 户 界面 上 。AndroidNdkDemo 示例 
的 界面 如 图 11.4 所 示 o 

进行 Android NDK 开发 一 般 要 经 过 如 下 的 
PR: 


(D 建立 Android 工程 ; 图 11.4 AndroidNdkDemo 示例 界面 
(2) 建立 Android. mk 文件 ; 
(3) 建立 C 源 代码 文件 ; 


264 A 


(4) 编译 共享 库 模块 ; 
(5) 运行 Android 程序 。 


1. 建立 Android 工程 


首先 在 Eclipse 中 建立 Android 工程 时 ,工程 名 称 为 AndroidNdkDemo, 并 在 工程 中 
建立 一 个 新 目录 jni, 用 来 保存 C/C++ 代码 文件 。jni 的 子 目录 结构 不 必 遵 循 Java 代码 的 目 
录 结 构 , 如 com. mycompany. myproject, 可 以 将 所 
4 加 AndroidNdkDemo 有 的 C/C++ 代码 文件 放置 在 jni 目录 下 ,也 可 以 

pf RR 创建 子 目录 保存 ,并 不 影响 最 后 的 编译 结果 。 
到 ee eh AndroidNdkDemo 工程 的 目录 结构 如 图 11. 5 
b BÀ Android 4.0 所 示 。 


trina 这 个 示例 中 采用 * 自 顶 向 下 ”的 方式 进行 开 

en 发 ,首先 编写 Anroid 程序 的 用 户 界面 ,然后 开发 
E AndroidManifestaml C/C++ 的 共享 库 。 为 了 调试 方便 , 先 在 Java 代码 

es 中 编写 一 个 功能 相近 函数 ,在 用 户 界面 调试 中 使 

用 , 当 完 成 C/C++ 的 共享 库 开 发 后 ,再 用 共享 库 
图 11.5 AndroidNdkDemo 工程 目录 结构 “中 的 函数 替代 这 个 Java 代码 函数 。 

在 建立 AndroidNdkDemo 工程 后 ,修改 main. xml 文件 ,添加 一 个 id Jy display 的 
TextView 和 一 个 id Jy add_btn 的 Button 按钮 。 程 序 中 产生 随机 数 和 调用 的 代码 在 
AndroidNdkDemoActivity. java 文件 中 ,下 面 是 AndroidNdkDemoActivity. java 文件 的 
核心 代码 。 


1 public class AndroidNdkDemozcitivity extends Activity ( 

2 GOverride 

3 public void onCreate (Bundle savedInstanceState) { 

4 Super.onCreate (savedInstanceState) ; 

5 setContentView (R. layout main) ; 

6 final TextView displayLable- (TextView)findViewById (R.id.display); 
2 Button btn- (Button) findviewById (R.id.add btn); 

8 btn.setonclickListener (new View.OnClickListener () ( 

9 


GOverride 
10 püblic void onClick(View v) ( 
11 double randamDouble- Math. random () ; 
12 long x-Math.round (randamDouble * 100); 
13 randamDouble- Math.random() ; 
14 long y-Math.round (randamDouble * 100); 
15 
16 //System. loadLibrary ("add- module") ; 
17 long z-add(x, y); 


18 String msg- xt "+ "+ yr "= "+ z; 
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19 displaylable.setText (msg) ; 
20 } 

2 Ds; 

2 ) 

23 //public native long add(long x, long y); 
24 

25 public long add (long x, long y)( 

26 return x* y; 

27 } 

28 |} 


在 代码 第 17 行 本 应 该 调用 共享 库 的 add() 函 数 , 但 为 了 便于 开发 和 调试 ,在 代码 第 
25 行 ~~ 第 27 行 ,使 用 Java 代码 开发 了 一 个 功能 相同 的 add() 函 数 , 这 样 即使 没有 完成 
C/C++ 共享 库 的 开发 前 ,也 可 以 对 Android 工程 进行 界面 部 分 的 调试 。 

第 16 行 和 第 23 行 注释 掉 的 代码 ,就 是 在 C/C++ 的 共享 库 开 发 完毕 后 需要 使 用 的 代 
码 , 其 中 第 16 行 是 动态 加 载 共享 库 的 代码 ,加 载 的 共享 库 名 称 为 add-module。 动 态 加 载 
是 在 调用 共享 库 中 的 函数 前 ,在 程序 代码 中 指明 需要 加 载 的 模块 名 称 。 除 了 动态 加 载 以 
外 ,程序 开发 人 员 还 可 以 使 用 静态 加 载 的 方式 ,在 类 加 载 时 加 载 共享 库 , 代 码 如 下 。 


static( 
System. loadLibrary ("acd- module") ; 
) 


第 23 行 用 来 声明 共享 库 中 的 add() 函 数 ,必须 使 用 与 C/C++ 代码 文件 同名 的 函数 。 
在 共享 库 开 发 完毕 后 ,取消 第 16 行 和 第 23 行 代码 的 注释 ,并 注释 掉 第 25 行 一 第 27 行 的 
代码 ,这样 程序 就 可 以 正常 调用 共享 库 内 的 函数 进行 加 法 运算 。 


2. 建立 Android. mk 文件 


Android. mk 是 jni 根 目 录 下 必须 存在 描述 C/C++ 代码 文件 模块 信息 的 文件 ,将 代 
码 模块 的 编译 信息 传递 给 NDK 编译 系统 ,是 NDK 编译 系统 编译 脚本 的 一 部 分 。 在 编写 
C/C++ 源 代码 文件 前 ,首先 在 jni 目录 中 建立 Android. mk 文件 。 

一 般 情况 下 ,NDK 编译 系统 会 搜寻 二 project 二 /jni 目录 中 的 Android. mk 文件 ,其 
中 二 project 二 是 Android 的 工程 目录 。 但 如 果 程 序 开 发 人 员 将 Android. mk 文件 放置 在 
下 一 级 目录 中 , 则 需要 在 上 一 级 目录 中 的 Android. mk 文件 中 告知 NDK 编译 系统 遍历 
所 有 子 目录 中 的 Android. mk 文件 ,在 jni 目录 下 Android. mk 文件 添加 的 代码 如 下 。 


include $ (call all- subdir- makefiles) 


下 面 来 分 析 AndroidNdkDemo 示例 jni 目录 下 的 Android. mk X fF, Android. mk 
文件 的 代码 如 下 。 
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IOCAL PATH :=$ (call my- dir) 


include$ (CIEAR VARS) 


IOCAL MOUE —— :-adi- module 
IOCAL SRC FILES :- add- module.c 


Oo - o OU & Und 


include $ (BUILD SHARED LIERARY) 


每 个 Android. mk 文件 都 必须 以 第 1 行 代 码 开始 ,变量 LOCAL. PATH 用 来 定义 需 
要 编译 的 C/C++ 源 代码 的 位 置 ,my-dir 由 NDK 编译 系统 提供 ,表示 当前 目录 的 位 置 。 
在 AndroidNdkDemo 示例 中 ,my-dir 表示 Android. mk 所 在 的 jni 目录 。 

代码 第 3 行 的 include $ (CLEAR_VARS) 表 示 清 空 所 有 以 LOCAL_ 开始 的 变量 , 例 
如 LOCAL_MODULE、LOCAL_SRC_FILES、LOCAL_STATIC_LIBRARIES 等 ,但 第 
1 行 定义 的 LOCAL_PATH 不 在 清空 的 范围 内 。 因 为 所 有 的 编译 脚本 都 将 在 同一 个 
GNU Make 的 执行 环境 中 ,而 且 所 有 变量 都 是 全 局 变量 ,因此 在 每 次 使 用 前 必须 清空 以 
前 用 过 的 变量 。 

第 5 行 代码 变量 LOCAL MODULE 用 来 声明 模块 名 称 ,模块 名 称 必须 唯一 ,而 且 中 
间 不 能 存在 空格 。NDK 编译 系统 将 会 在 模块 名 称 前 自动 添加 lib 前 级 ,然后 生成 so X 
件 。 这 里 的 模块 名 称 为 add-module, 生 成 的 共享 库 文件 名 为 libadd-module. so。 但 需要 
注意 的 是 ,如 果 程 序 开发 人 员 使 用 具有 lib 前 级 的 模块 名 称 , NDK 编译 系统 将 不 再 添加 
前 级 ,例如 模块 名 称 为 libsub, 生 成 的 共享 库 文 件 名 为 libsub. so. 

第 6 行 代码 中 的 变量 LOCAL_SRC_FILES 表示 编译 模块 所 需要 使 用 的 C/C++ 
文件 列表 ,但 不 需要 给 出 头 文件 的 列表 ,因为 NDK 编译 系统 会 自动 计算 依赖 关系 。 
add-module 模块 仅 需要 一 个 C 文 件 ,文件 名 为 add-module. c。 默 认 情 况 下 ,文件 后 组 
名 为 .c 的 文件 是 C 语言 源 文件 ,文件 后 缀 名 为 . cpp 的 文件 是 C++ 语言 源 文件 。 

第 8 行 代码 include $ (BUILD_SHARED_LIBRARY) 表 示 Android NDK 编译 系统 
需要 构建 共享 库 , 如 果 变 量 BUILD. SHARED. LIBRARY 更 改 为 BUILD_STATIC _ 
LIBRARY, 则 表示 需要 NDK 编译 系统 构建 静态 库 。 共 享 库 和 静态 库 文件 有 着 不 同 的 用 
3& ,共享 库 可 以 被 Android 工程 中 的 Java 代码 调用 .并 打包 到 apk 文件 中 。 静 态 库 不 能 
被 Java 代码 调用 ,也 不 能 打包 到 apk 文件 中 ,只 能 在 生产 共享 库 的 过 程 中 被 共享 库 中 的 
C/C++ 代码 所 调用 。 


3. 建立 C 源 代码 文件 


根据 Android. mk 文件 的 声明 ,add-module 模块 仅 包含 一 个 C 源 代码 文件 add- 
module. ce。 那么 在 jni 目录 中 建立 add-module.c 文 件 , 在 该 文件 中 实现 整数 加 法 运算 功 
能 ,全 部 代码 如 下 。 


1 # include jni.h> 

2 

3 jlong Java edu hrbeu AndroidNdkDemo AndroidNdkDemoActivity add (JNIEnv *env, jobject this, 
jlong x, jlog y) 

4 { 

5 retum x* y; 

6 ) 


代码 第 1 行 引 入 的 是 JNI(Java Native Interface) f] 3; Sc fF, REE 3 行 是 函数 名 
称 ,jlong 表示 Java K 789 SE Xt. Java. edu. hrbeu. AndroidNdkDemo AndroidNdkDemo 
Activity add 的 构成 为 Java 去 包 名 称 二 _ 志 类 二 — EACH PC H8 FCRC 
要 与 Android 工程 中 AndroidNdkDemoActivity. java 文件 定义 的 函数 一 致 。 
AndroidNdkDemoActivity. java 文件 定义 的 函数 为 public native long add(long x. long y). 
第 5 行 代码 用 来 返回 加 法 运算 结 


4. 编译 共享 库 模块 


到 目前 为 止 , 编 译 前 的 准备 工作 基本 就 绪 , 程 序 开发 人 员 可 以 编译 C 语言 开发 的 共 
享 库 模块 了 。 首 先 启 动 Cygwin ,然后 切换 到 Android NDK 的 主 目录 下 ,键入 如 下 的 编 


译 命令 : 


export NDK- /cygdrive/g/Android/android-ndk-r85 


export 是 Linux 下 的 变量 设置 命令 ,设置 一 个 名 为 NDK 的 变量 (变量 名 称 可 以 更 
换 ) ,用 来 保存 Android NDK 的 主 目录 位 - 笔者 的 NDK 保存 在 GA 
ndk-r6b, 因 此 在 Cygwin 中 的 目录 则 是 /cygdrive/g/Android/android-ndk-r6b。 设 置 
NDK 变量 的 目的 是 简化 后 面 编译 过 程 中 的 命令 输入 操作 。 程 序 开 发 人 员 可 以 使 用 
Linux 的 echo 命令 查看 NDK 变量 的 值 ,如 图 11.6 所 示 。 


C /cyodrive/g/Android/android-ndk-r6b c ees 


11.6 NDK 变量 设置 与 查看 


然后 使 用 cd 命令 和 cd.. bin Android 的 工程 目录 下 ,使 用 Android NDK H 
录 中 提供 的 脚本 文件 ndk-build C 代码 模块 。ndk-build 脚本 是 Android NDK 为 简 
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化 编译 过 程 而 在 v4 版 本 推出 的 ,该 脚本 会 自动 探索 Android 工程 目录 中 的 文件 ,以 确定 
哪些 文件 需要 编译 ,以 及 如 何 进行 编译 。 程 序 开 发 人 员 只 需要 在 Android 的 工程 目录 下 
输入 如 下 命令 : 


SNDEVndk- build 


编译 成 功 的 提示 如 图 11.7 所 示 。 提 示 信 息 说 明 将 add-module. c 源 文 件 编译 成 add- 
module 模块 ,产生 的 libadd-module. so X fF f& ff f£ — project /libs/armeabi 目录 中 。 


E /cyadrive/g/Android/workplace/AndroidNdkDemo [IIS] XE 


图 11.7 编译 成 功 提 示 


5. 运行 Android 程序 


在 运行 AndroidNdkDemo 示例 程序 前 .务必 将 AndroidNdkDemoActivity. java 文件 
中 第 16 行 和 第 23 行 的 注释 取消 ,并 注释 掉 第 25 行 一 第 27 行 的 代码 。 

代码 修改 后 ,AndroidNdkDemo 示例 将 调用 libadd-module. so 文件 中 的 add O 函数 ， 
完成 加 法 运算 ,并 将 结果 显示 在 用 户 界 面 上 。 


115. NK 高 级 示例 


本 节 将 以 谷歌 Android NDK 中 提供 的 示例 代码 hello-neon 为 例 ,说 明 如 何在 代码 中 
动态 检测 CPU 类 型 ,并 根据 CPU 类 型 对 C 代码 中 的 算法 进行 优化 。 

hello-neon 示例 分 别 使 用 C 语言 和 NEON 指令 
集 实现 了 FIR( 有 限 长 脉冲 响应 ) 滤 波 器 算法 ,并 在 程 A 
序 中 分 别 运行 C 语言 和 NEON 指令 集 版 本 的 FIR 算 
法 (前 提 条 件 是 手机 CPU 支持 NEON 指令 集 ) ,将 两 
个 版 本 算法 的 运算 时 间 显示 在 用 户 界 面 上 ,如 图 11.8 
所 示 。 

下 面 来 介绍 两 个 概念 FIR 滤波 器 和 NEON。 
FIR 滤波 器 是 数字 滤波 器 的 一 种 ,是 对 数字 信号 进行 iid 
滤波 处 理 以 得 到 期 望 的 响应 特性 的 离散 时 间 系 统 。FIR 滤波 器 的 具体 算法 内 容 已 超出 
本 书 的 讨论 范围 ,具体 内 容 可 以 查阅 相关 资料 。NEON 是 通用 的 单 指令 多 数据 引擎 , 通 
过 一 次 处 理 多 个 数据 ,可 加 速 多 媒体 和 信和 号 的 处 理 算法 ,但 需要 CPU 的 硬件 支持 。 
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hello-neon 示例 在 二 Android NDK- /samples/hello-neon 目录 中 。 在 Eclipse 中 , 通 
过 File Import General Existing Projects into Workspace 命令 ,将 hello-neon 示例 
代码 导入 到 Eclipse, 如 图 11. 9 所 示 。 在 Select root directory 中 选择 hello-neon 所 在 的 
目录 ,并 将 复 选 框 Copy projects into workspace 选 上 ,这 样 不 仅 能 够 将 hello-neon 工程 导 
人 到 Eclipse 中 ,还 同时 将 hello-neon 示例 的 所 有 文件 都 复制 到 用 户 的 工作 空间 中 。 

按照 上 一 小 节 AndroidNdkDemo 示例 提供 的 方法 进行 编译 ,编译 后 在 Eclipse 中 的 
hello-neon 工程 上 选择 刷新 (Refresh), 新 生成 的 目录 和 文件 便 可 显示 在 Eclipse 的 
Package Explorer 中 ,如 图 11. 10 所 示 。 


I Package Explorer 2 B&je"-8 
E HelloNeon 
m S sc 


Import Projects. E com.example.neon 
Select a directory to search for existing Eclipse projects. [= HelloNeonjava 


eA 8 gen [Generated Java Files] 
mÀ Android 4.0 
B assets 
J B bn 
Brojects: | Sji 
â [E] Android.mk 
HeloNeon (GMAndroid\android-ndk-r6b\samples\hello-neon) 


© Select root directory: GAAndroid\endroid-ndk-réb\samples\hello-neo [Browse] | 


|| © select archive fle: [ [ Browse.. 


= (E) Applicatonmk 
Deselect All 图 helloneon-intrinsics.c 
x [E] helloneon-intrinsics.h 
Dm 图 helloneon.c 
$ libs 
W|Copy projects into workspace © armeabi 
Working sets libhelloneon.so 
[El Add project to working sets 9 armeabi-v7a 


libhelloneon.so 


ets: [ =) [ seee. 


中 B res 

B AndroidManifestxml 
- ——4—— 国 proguard.cíg 

@ [Beo] mens | nh Cancel 国 project.properties 


图 11.9 导入 hello-neon 示例 Æ 11.10 ”hello-neon 示例 的 目录 结构 


与 AndroidNdkDemo 示例 对 比 ,hello-neon 示例 在 jni 目录 中 多 了 一 个 Application. 
mk 的 文件 ,而 且 在 libs 目录 中 增加 了 一 个 新 目录 armeabi-v7a, 与 armeabi 目录 具有 同名 


的 文件 libhelloneon. so。 后 面 的 内 容 会 详细 介绍 这 些 新 目录 和 新 文件 的 作用 和 使 用 
方法 。 


1. HelloNeon. java 文件 


从 Android 工程 中 的 HelloNeon. java 文件 开始 说 明 ,此 文件 主要 实现 了 一 个 用 于 界 
面 的 Activity 类 ,并 通过 调用 共享 库 “helloneon” 中 的 stringFromJ NIO 函数 ,将 获取 的 字 
符 串 显 示 在 用 户 界面 上 。HelloNeon. java 文件 的 代码 如 下 。 


package oam.example.neon; 


inport android.app.Activity; 


1 
2 
3 
4 inport android.os.Bundle; 
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5 inport android.widget.TextView; 

6 

7 public class HelldNeon extends Activity 

8 { 

9 GOverride 

10 public void onCreate (Bundle savedInstanceState) 
1 { 

2 Super .onCreate (savedInstanceState) ; 
13 TextView tv- new TextView(this); 

14 tv.setText ( stringFramNI () ); 

15 setContentView (tv) ; 

16 } 

17 

18 public native String stringFramNNI () ; 

19 

20 static( 

2 System. loadLibrary ("hel lonecn") ; 

2 ) 

23 } 


代码 第 14 行 调用 本 地 方法 stringFromI NIO ,返回 的 字符 串 信 息 供 TextView 显示 。 
代码 第 18 行 用 来 声明 本 地 方法 ,其 中 native 是 声明 本 地 方法 的 标识 。 代 码 第 20 一 
第 22 行 , 使 用 静态 方式 加 载 共享 库 helloneon ,根据 共享 库 的 命名 规则 可 知 ,共享 库 的 文 
件 名 称 应 为 libhelloneon. so。 


2. Application, mk 文件 


Application. mk 文件 定义 了 应 用 程序 编译 的 基本 信息 ,是 Android NDK 编译 系统 
中 的 非 必 备 文件 ,如 果 出 现 , 应 保存 在 二 Android NDK 二 /jni 目录 中 。hello-neon 示例 的 
Application. mk 文件 的 代码 如 下 : 


3 3 Build both ARMjSTE and ARMv7- A machine code. 
2 APP ABI:-ammeabi ameabi- via 


Application. mk 文件 中 的 有 效 代码 只 有 一 行 。 第 1 行 是 注释 信息 ,说 明 Android 
NDK 编译 系统 将 同时 为 ARMv5TE 和 ARMv7-A 指令 集 的 CPU 编译 两 种 机 器 码 。 第 
2 行 则 是 有 效 代码 ,变量 APP. ABI 是 用 来 指定 所 支持 的 ABI, 代 码 的 含义 是 编译 支持 
armeabi 和 armeabi-v7a 的 两 个 共享 库 。 

ABI 是 二 进 制 代码 接口 (Application Binary Interface) .是 与 CPU 指令 集 密切 相关 
的 接口 规范 。Android NDK 编译 系统 支持 3 种 ABI: armeabi,armeabi-v7a 和 x86 ,分 别 
对 应 ARMvSTE, ARMv? — A 和 X86 指令 集 的 CPU。 在 不 指定 ABI 的 情况 下 ,Android 
NDK 默认 的 ABI 为 armeabi。 
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在 本 示例 中 同时 指定 了 两 个 ABI, 编 译 时 会 生成 两 个 同名 的 共享 库 文 件 , 然 后 分 别 
复制 到 Android 工程 的 libs\<ABI> H trf. ABI ERA abi 关键 字 的 目录 名 称 , 例 
如 在 本 例 中 libs 目录 下 生成 两 个 子 目录 ,分 别 是 armeabi 和 armeabi-v7a, 这 两 个 目录 中 
都 有 libhelloneon. so X fF. Æ Android 工程 打包 时 ,这 两 个 库 文 件 都 会 被 打包 在 apk X 
件 中 ,这 种 支持 多 个 CPU 体系 结构 的 apk 文件 称 为 “ 胖 二 进 制 包 ”(fat binary), apk X 
件 在 Android 系统 进行 安装 时 ,系统 的 包 管 理 器 (package manager) 会 根据 CPU 类 型 选 
择 合 适 的 动态 库 ,而 不 会 将 不 支持 的 动态 库 安装 到 Android 系统 中 。 

为 验证 上 面 的 描述 ,用户 可 以 将 编译 成 功 的 二 project 字 \bin\HelloNeon. apk 文件 解 
压 , 在 libs 目录 中 可 以 分 别 在 armeabi 和 armeabi-v7a 目录 找到 两 个 libhelloneon. so X: 
件 。 然 后 使 用 Eclipse 的 DDMS 模式 ,在 File Explorer 中 浏览 已 安装 程序 的 数据 信息 ， 
本 示例 安装 后 的 共享 库 文件 保存 在 \data\data\com. example. neonMib 中 ,在 这 个 目录 中 
只 能 找到 一 个 libhelloneon. so 文件 ,说 明 包 管 理 器 已 经 根据 CPU 类 型 对 动态 库 进行 了 
选择 。 

Application. mk 的 变量 说 明 可 以 参考 表 11. 3。 

表 11.3 Application. mk 的 变量 说 明 


zo m 强制 使 用 说 明 
APP PROJECT PATH "m Android 工程 所 在 的 目录 
需 编 译 的 模块 列表 。 如 不 指定 , NDK 将 编译 所 有 在 
APP MODULES 否 Android. mk 中 声明 的 模块 ;如 果 指 定 , 则 应 是 以 空格 作为 分 


隔 符 的 模块 列表 ,NDK 会 自动 计算 模块 之 间 的 依赖 关系 
指定 debug 或 release 模式 。release 是 默认 设置 ,产生 高 度 优化 


APESDESTIM 750 | 的 二 进 制 代码 ,debug 则 会 产生 非 优化 代码 ,更 加 易于 调试 
APP CFLAGS E 编译 C/C++ 代码 时 的 编译 器 参数 

APP CXXFLAGS 否 | 5 APP CPPFLAGS 相同 ,后 续 版 本 将 取消 此 变量 
APP_CPPFLAGS E 编译 C++ 代码 时 的 编译 器 参数 

APP_BUILD_SCRIPT A 脚 村 所 在 的 目录 , 辕 认 在 < Anroid NDK> 
APP. ABI 指定 ABI 类 型 

APP_STL 指定 STL 类 型 


3. Android. mk 文件 


hello-neon 示例 的 Android. mk 文件 .不 仅 声明 了 需要 编译 的 模块 信息 ,还 引用 了 
Android NDK 的 一 个 静态 库 cpufeatures。 

cpufeatures 是 用 来 检测 CPU 类 型 的 模块 ,其 源 代码 在 二 Android NDK>\sources\ 
android\cpufeatures 目录 中 , 共 3 个 文件 ,Android. mk、cpu-features. h 和 cpu-features. c 
分 别 是 模块 声明 文件 、 头 文件 和 源 代码 文件 。 分 析 cpufeatures 中 的 Android. mk 代码 可 
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以 发 现 ,这 些 文件 为 Android NDK 编译 系统 提供 了 静态 库 cpufeatures, 供 其 他 模块 在 检 
W CPU 类 型 时 调用 。cpufeatures 中 Android. mk 文件 的 代码 如 下 。 


IOCAL PATH :=$ (call my- dir) 


include $ (CLEAR. VARS) 

ICAL MODUIE := cpufeatures 
IOCAL SRC FIIES := cpu features.c 
IOCAL EXPORT C INCLUDES :— $ (LOCAL PATH) 
include $ (BUILD STATIC LIBRARY) 


- o Ut & Qn n 


cpu-features. h 头 文件 声明 了 android_getCpuFamily() 函 数 ,而 具体 的 C 语言 实现 
则 在 cpu-features. c 文件 中 。cpu-features. h 的 函数 声明 代码 如 下 。 


extem AndroidopuFamily android getCpuFamily (void); 


TE T fit cpufeatures 模块 的 用 途 和 函数 后 ,下 一 步 对 hello-neon 示例 的 Android. mk 
文件 进行 分 析 。hello-neon 示例 的 Android. mk 文件 的 代码 如 下 。 


IOCAL PATH :=$ (call my- dir) 
include $ (CLEAR VARS) 


1 

2 

3 

4 IOCAL MODULE :- helloneon 
5 IOCAL SRC FIIES :-helloneon.c 
6 

7 

8 

9 


ifeq($ (TARGET ARCH ABI),ameabi- v7a) 
IOCAL CFIAGS :- - DHAVE NEON- 1 
ICAL SRC FIIES* — helloneon- intrinsics.c.neon 
10  endif 


12  IOCAL STATIC LIBRARIES := cpufeatures 
13 IOL IDLIBS :- - llog 


14 include S(BUILD SHARED LIBRARY) 


16  $(call import- module, cpufeatures) 


代码 第 1 一 第 5 行 的 内 容 已 经 在 上 一 个 示例 中 进行 了 详细 的 介绍 ,这 里 不 再 重复 说 
明 。 代 码 第 7 行 的 ifeq 用 来 判断 变量 TARGET_ARCH_ABI 是 否 为 armeabi-v7a。 
TARGET_ARCH_ABI 变量 由 Android NDK 提供 ,表示 目标 CPU 和 ABI 类 型 ,该 变量 
仅 支持 两 个 值 : armeabi 和 armeabi-v7a. 分 别 代 表 ARMv5TE 和 ARMv7-A 指令 集 
的 CPU。 


仅 当 编译 的 目标 ABI 为 armeabi-v7a 时 ,代码 第 8 行 和 第 9 行 才 被 运行 。 第 8 行 代 
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码 向 GCC 编译 器 传递 参数 “-DHAVE_NEON= 二 1”, 此 参数 为 GCC 定义 宏 符号 HAVE_ 
NEON.HAVE NEON 符号 的 值 为 1。 第 9 行 表示 增加 一 个 源 文件 ,文件 名 称 为 
helloneon-intrinsics. c,; 后 级 . neon 表示 该 文件 仅 在 NEON 模式 下 才 被 编译 。 

代码 第 12 行 表示 在 Android NDK 编译 时 需要 连接 的 静态 库 文件 列表 ,这 里 有 一 个 
静态 库 为 cpufeatures。 代 码 第 13 行 表示 编译 时 需要 额外 连接 的 系统 库 文件 ,这 里 要 连 
接 的 系统 库 文件 应 为 /system/lib/liblog. so。 代 码 第 15 行 表示 Android NDK 编译 系统 
需要 构建 共享 库 。 代 码 第 16 行 表 示 通 过 名 称 cpufeatures 引入 所 需 的 模块 。 


4. C 语言 文件 和 头 文件 
hello-neon 示例 中 的 C 语言 文件 和 头 文件 一 共有 3 个 ,分 别 是 helloneon-intrinsics. 


c,helloneon-intrinsics. h 和 helloneon. c. 
其 中 , helloneon-intrinsics. c 实现 了 NEON 指令 集 的 FIR 算法 , helloneon- 
intrinsics. h 是 头 文件 ,声明 调用 NEON 版 本 FIR 算法 的 函数 : 


void fir filter neon intrinsics(short *output, const short *input, const short 
*kermel, int width, int kernelSize); 


helloneon. c 中 首先 实现 了 C 语言 版 本 FIR 算法 ,其 调用 函数 为 


fir filter c(short * output, const short *input, const short *kernel, int width, int kernelSize) 


helloneon. c 中 还 定义 了 被 Java 代码 调用 的 接口 函数 ,核心 代码 如 下 : 


jstring Java om example nen HelloNeon stringEromNI (INIFrv* ew, jd»ject thiz) 


最 后 ,helloneon. c 分 别 在 代码 中 记录 NEON 和 C 语言 版 本 FIR 算法 的 运行 时 间 ， 
将 结果 以 字符 串 的 形式 返回 给 函数 调用 者 。 


3 Es 


1. 简 述 Android NDK 开发 的 优势 和 不 足 。 

2. 说 明 Android NDK 应 用 程序 开发 的 一 般 步骤 。 

3. 参考 NDK 的 two-libs 示例 ,使 用 静态 库 实现 AndroidNdkDemo 示例 中 加 法 运算 
的 函数 功能 。 

4. 使 用 NDK 能 够 提高 复杂 函数 的 运算 速度 ,但 程序 运行 效率 的 提升 并 不 容易 度 
量 。 分 别 使 用 C/C++ 和 Java 语言 设计 一 个 具有 复杂 运算 的 函数 ,通过 对 比 函数 的 调用 
和 返回 时 间 , 分 析 NDK 对 提高 程序 运行 效率 的 能 力 。 

5. 简 述 在 代码 中 动态 检测 CPU 类 型 的 意义 。 
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综合 示例 设计 与 开发 


本 章 将 以 “天 气 预 报 软件 ”作为 示例 ,综合 运用 以 往 章节 所 学 习 的 知识 和 技巧 ,从 需 
求 分 析 、 界 面 设计 、 模 块 设计 和 程序 开发 等 几 个 方面 ,详细 介绍 Android 应 用 程序 的 设计 
思路 与 开发 方法 。 通 过 本 章 的 学 习 可 以 让 读者 掌握 Android 应 用 程序 的 设计 方法 和 多 
种 组 件 应 用 的 能 力 。 

本 章 学 习 目 标 : 

。 掌握 Android 应 用 程序 的 基本 设计 方法 和 思路 ; 

。 掌握 使 用 多 种 组 件 进行 Android 程序 开发 的 方法 。 
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通过 前 面 章 节 的 学 习 , 读 者 应 该 已 经 掌握 了 一 些 Android 应 用 程序 开发 的 知识 和 方 
法 ,但 如 何 能 够 综合 地 运用 这 些 知识 和 方法 ,解决 实际 开发 中 所 过 到 的 问题 ,还 是 一 个 需 
要 继续 学 习 和 探讨 的 问题 。 设 计 本 章 的 初衷 就 是 希望 读者 能 够 根据 实际 项 目的 需求 , 准 
确 地 分 析 Android 应 用 程序 开发 可 能 涉及 的 知识 点 ,通过 分 析 软 件 的 需求 ,快速 设计 用 
户 界 面 和 模块 结构 ,并 最 终 完成 应 用 程序 的 开发 和 调试 。 

本 章 提供 的 天 气 预报 软件 是 一 个 略微 复杂 的 示例 。 在 这 个 综合 示例 中 ,有 一 个 显示 
天 气 情况 的 用 户 界面 ,可 以 通过 图 片 和 文字 显示 当前 和 未 来 几 天 的 天 气 状 况 ,包括 温度 、 
湿度 、 风 向 和 雨 雪 情 况 等 。 这 些 天 气 数据 是 通过 后 台 服 务 获取 的 ,这 个 后 台 服务 按照 一 
定时 间 间 隔 , 从 Google 上 获取 天 气 预 报信 息 , 并 将 天 气 信息 保存 在 后 台 服 务 中 。 示 例 还 
需要 提供 基于 SMS 短信 的 天 气 数据 服务 ,其 他 手机 用 户 可 以 向 本 示例 所 在 的 手机 上 发 
送 SMS 短信 ,在 短信 中 包含 特定 的 关键 字 , 则 可 以 将 已 有 的 天 气 情况 通过 SMS 短信 回 
复 给 用 户 。 最 后 ,每 个 被 发 送 的 SMS 短信 都 会 被 记录 下 来 ,用 户 可 以 浏览 或 删除 这 些 记 
录 信 息 。 

从 上 面 的 描述 中 可 以 基本 了 解 软 件 的 功能 需求 ,但 为 了 将 需求 分 析 过 程 变 得 简单 明 
了 ,首先 找 出 用 户 界面 上 需要 显示 的 内 容 。 功 能 描述 中 有 “显示 天 气 情况 的 用 户 界面 "和 
“用 户 可 以 浏览 或 删除 这 些 记 录 信 息 ”, 除 此 以 外 ,一 般 应 用 软件 还 应 有 显示 配置 信息 的 
界面 。 因 此 ,本 示例 应 该 包含 三 个 用 户 界面 : 

(1) 显示 天 气 预报 的 用 户 界面 ; 
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(2) 显示 已 发 送 SMS 短信 的 用 户 界面 ; 

(3) 浏览 和 设置 配置 信息 的 用 户 界面 。 

下 一 步 从 用 户 界面 出 发 ,分 析 隐 藏 在 界面 后 面 的 内 部 功能 ,这 些 功能 是 程序 正常 运 
行 的 基础 。 在 “显示 天 气 预 报 的 用 户 界面 "中 ,为 了 在 界面 上 显示 天 气 信息 , 则 需要 从 互 
联网 获取 天 气 数据 的 功能 ,并 将 天 气 数据 信息 保存 在 程序 内 部 。 而 在 “显示 已 发 送 SMS 
短信 的 用 户 界面 "中 , 则 需要 提供 监视 接收 短信 关键 字 的 功能 ,并 且 支 持 发 送 包 含 天 气 信 
Aff SMS 短信 。 除 此 以 外 ,为 了 能 够 浏览 短信 信息 ,还 需要 提供 数据 库 功 能 ,将 短信 回 
复 信息 保存 到 数据 库 中 。 在 “浏览 和 设置 配置 信息 的 用 户 界面 ”中 ,应 提供 配置 信息 的 保 
存 和 读 取 功能 ,并 能 够 恢复 软件 的 默认 设置 。 

根据 用 户 的 功能 需求 ,用 户 界面 和 内 部 功能 的 关系 如 下 所 示 。 

(1) 显示 天 气 预报 的 用 户 界面 ; 

(D 获取 Google 的 天 气 数据 ; 

© 保存 天 气 数据 信息 。 

(2) 显示 SMS 短信 的 用 户 界 面 ; 

(D 根据 关键 字 监 视 SMS 短信 ; 

© 发 送 包 含 天 气 信息 的 SMS 短信 ; 

© 将 发 送 SMS 短信 的 相关 信息 写 人 数据 库 。 

(3) 浏览 和 设置 配置 信息 的 用 户 界面 ; 

CD 将 用 户 设置 的 配置 信息 保存 到 数据 库 ; 

© 启动 时 读 取 数 据 库 中 的 配置 信息 ; 

© 支持 恢复 默认 设置 。 

天 气 预 报 软件 的 用 户 界面 和 内 部 功能 已 经 分 析 完 成 ,下 一 步 工作 是 根据 用 户 界面 的 
需求 ,详细 设计 每 个 用 户 界面 的 具体 内 容 , 并 划分 软件 的 功能 模块 ,以 及 确定 软件 功能 模 
块 之 间 的 调用 关系 。 


122 Z F 3 t 


在 本 节 中 ,将 从 三 个 方面 介绍 综合 示例 程序 的 设计 方法 ,首先 介绍 用 户 界面 的 设计 ， 
然后 介绍 数据 库 的 设计 ,最 后 介绍 程序 模块 的 设计 。 


121 用 户 界面 设计 


根据 需求 中 的 用 户 界面 分 析 , 应 用 程序 应 包含 三 个 主要 的 用 户 界面 ,这 里 则 需要 进 
一 步 分 析 每 个 用 户 界面 中 应 该 包含 哪些 显示 内 容 。 

在 显示 天 气 预报 的 用 户 界面 中 ,显示 目标 城市 的 当前 的 天 气 状况 ,包括 城市 名 称 、 温 
度 , 湿 度 、 风 向 、 雨 雪 情 况 和 获取 数据 时 间 等 信息 。 在 界面 的 下 方 显示 未 来 四 天 的 天 气 状 
况 , 但 仅 包括 温度 和 雨 雪 情 况 。 

在 显示 已 发 送 SMS 短信 的 用 户 界 面 中 ,显示 每 个 回复 短信 的 时 间 、 目 标 手机 号 码 、 
城市 名 称 、 当 天 的 天 气 状况 和 未 来 一 天 的 天 气 状况 。 
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在 浏览 和 设置 配置 信息 的 用 户 界面 中 ,显示 希望 获取 天 气 预报 的 城市 名 称 、 获 取 数 
据 的 频率 和 短信 监视 的 关键 字 , 并 允许 用 户 设置 是 否 提供 短信 服务 ,以 及 是 否 记 录 回 复 
短信 信息 。 

根据 对 用 户 界面 显示 内 容 的 分 析 ,绘制 出 用 户 界面 的 草图 ,如 图 12. 1 所 示 。 
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图 12.1 用 户 界面 的 草图 
在 初步 完成 用 户 界面 设计 后 ,下 一 步 进入 应 用 程序 的 数据 库 设计 。 
1222 数据 库 设 计 


本 示例 主要 有 两 种 数据 需要 存储 ,一 个 是 配置 信息 , 另 一 个 是 SMS 短信 服务 信息 。 
因为 配置 信息 的 数据 量 很 小 , 从 Android 支持 的 存储 方式 上 分 析 , 可 以 保存 在 
SharedPreference, 文件 或 SQLite 数据 库 中 。SMS 短信 服务 信息 是 一 个 随 着 时 间 推 移 而 
不 断 增 加 的 数据 ,属于 文本 信息 ,而 且 有 固定 的 格式 ,因此 适合 使 用 SQLite 数据 库 进行 
存储 。 综 合 分 析 这 两 个 需要 存储 的 数据 ,选择 SQLite 数据 库 作 为 存储 数据 的 方法 。 

配置 信息 中 主要 保存 目标 城市 的 名 称 ,访问 Google 更 新 天 气 信息 的 频率 ,请 求 天 气 
信息 服务 短信 的 关键 字 , 以 及 是 否 提 供 短信 服务 和 是 否 记录 短信 服务 内 容 。 配 置信 息 的 
数据 库 表 结构 如 表 12. 1 所 示 。 


表 12.1 配置 信息 的 数据 库 表 结 构 


属 性 数据 类 型 说 明 
id integer 自动 增加 的 主键 
city_name text 天 气 信息 查询 的 城市 名 
refresh_speed text 天 气 信息 查询 的 频率 ,单位 为 秒 /次 
sms service text 是 否 提供 短信 服务 , 即 接收 到 请 求 短信 后 是 否 回复 包含 天 气 信息 的 短信 
sms_info text 是 否 记录 发 出 的 SMS 短信 信息 


key_word text 短信 服务 的 关键 字 , 用 以 确定 哪 条 短信 是 请 求 天 气 服务 的 短信 
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SMS 短信 服务 信息 主要 保存 请 求 天 气 服务 短信 的 发 送 者 、 短 信 内 容 、 接 收 时 间 和 回 
复 信息 的 内 容 。SMS 短信 服务 信息 的 数据 库 表 结构 如 表 12. 2 所 示 。 
表 12.2 SMS 短信 服务 信息 的 数据 库 表 结 构 


属 性 数据 类 型 说 明 
id integer 自动 增加 的 主键 
sms_sender text 请 求 服务 短信 的 发 送 者 
sms_body text 请 求 服务 短信 的 内 容 信 息 
sms_receive_time text 接收 到 请 求 服务 短信 的 时 间 
return_result text 回复 短信 的 内 容 
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从 功能 需求 上 分 析 , 可 以 将 整个 应 用 程序 划分 为 4 个 模块 ,分 别 是 用 户 界 面 \ 后 台 服 
务 ,数据库 适配器 和 短信 监听 器 ,各 模块 之 间 的 关系 如 图 12. 2 所 示 。 


用 户 界面 

| 配 
xe nad 、 停止 服 务 H 
后 台 服务 配 | | 息 
天 气 信息 制 | | 二 
短信 监听 器 一 | 短信 发 送 子 模块 Mr: 
Google 天 气 ”| | 服务 请 求 短信 z TD 

Google X = " 
rr 数据 获取 子 模块 多 
| 短信 服务 信息 息 

二 一 一 一 
SQLite 数 据 库 数据 库 适 配器 


12.2 模块 结构 图 


从 模块 结构 图 中 不 难看 出 ,后 台 服 务 是 整个 应 用 程序 的 核心 ,主要 包含 数据 获取 
子 模块 和 短信 服务 子 模块 。 数 据 获取 子 模块 负责 周期 性 地 从 Google 获取 天 气 信 息 ; 短 
信服 务 子 模块 则 负责 处 理 接收 到 的 服务 请 求 短信 ,并 发 送 包 含 天 气 信 息 的 短信 。 后 台 
服务 由 用 户 界 面 通过 Intent 启动 .启动 后 的 后 台 服 务 可 以 在 用 户 界面 关闭 后 仍然 保持 
运行 状态 ,直到 用 户 通过 用 户 界面 发 送 Intent 停止 服务 .或 系统 因 资 源 不 足 而 强行 关 
闭 服务 。 

用 户 界面 从 后 台 服 务 获取 天 气 信息 , 而 没有 直接 通过 网 络 访问 Google 的 天 气 数 据 。 
之 所 以 这 么 设计 ,一 方面 是 因为 后 台 服 务 使 用 了 工作 线程 ,通过 后 台 服 务 获取 天 气 数据 
可 以 避免 因 网 络 通 信 不 畅 造成 界面 失去 响应 ; 另 一 方面 ,在 用 户 关 闭 界 面 后 ,后 台 服 务 仍 
然 需 要 更 新 天 气 信息 ,以 保证 短信 服务 数据 的 准确 性 。 用 户 界 面 通过 直接 调用 数据 库 适 
配器 ,向 SQLite 数据 库 中 读 写 配置 信息 ,或 对 SMS 短信 服务 信息 进行 操作 。 

短信 监听 器 是 一 个 BroadcastReceiver ,监视 所 有 接收 到 的 短信 。 如 果 短 信 中 包含 用 
户 自 定 义 的 关键 字 ,短信 监听 器 则 会 认为 这 条 短信 是 天 气 服务 请 求 短信 ,将 短信 的 相关 
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信息 写 人 后 台 服 务 的 短信 服务 队列 。 当 然 , 如 果 用 户 在 配置 信息 中 选择 无 须 提供 短信 服 
A ,短信 监听 器 仍然 继续 监听 所 有 短信 ,只 是 后 台 服 务 不 再 允许 将 服务 请 求 短信 写 人 服 
务 队 列 。 

数据 库 适 配器 封装 了 所 有 对 SQLite 数据 库 操作 的 方法 ,用 户 界 面 和 后 台 服 务 会 调 
用 它 实现 数据 库 操作 。 

在 完成 用 户 界面 设计 数据 库 设 计 和 模块 设计 后 ,程序 的 设计 阶段 基本 完成 ,下 面 进 
入 程序 开发 阶段 。 


123 程序 开发 


本 节 将 从 工程 文件 结构 数据库 适配器 ,短信 监听 器 .后台 服务 器 和 用 户 界 面 等 方 
面 ,介绍 综合 示例 的 程序 开发 细节 ,并 提供 详细 的 代码 和 内 容 分 析 。 


1231 工程 结构 


在 程序 开发 阶段 ,首先 确定 “天 气 预 报 软件 ?的 工程 名 称 为 WeatherDemo, 包 名 称 为 
edu. hrbeu. WeatherDemo。 然 后 根据 程序 模块 设计 的 内 容 , 建 立 WeatherDemo 示例 的 


文件 结构 ,WeatherDemo 示例 源 代码 的 文件 结构 如 图 12. 3 所 示 。 


4 GS WeatnerDemo 


a 
2 4 gres 
4 (9 src 
E le 
4 B eduhrbeu WeatherDemo "- ip 
» [D HistoryActivityjava x Bae 
» [D SetupActivityjava Ii tab story pog 
b [D WeatherActivityjava krpan z 
» [À WestherDemojava x Missi ien 
4 B edu.hrbeu.WeatherDemo.DB. e drewsble-hdoi od 
> I Configjava © drawable-Idpi 
» 国 DBAdapter java © drawable-mdpi 
4 B edu.hrbeu.WeatherDemo.Service 4 s loreet j 
u 


» D SmsReceiverjava 
» [) WeatherAdapter java 
» D WeatherServicejava 


R data row.xml 
国 tab historyxml 


R) tab setup.xml 
4 B eduhrbeu WeatherDemo.SMS gm 
" A 国 tab_weatherxml 
b 国 SimpleSmsjava 
. 4 (& values 
b [J] SmsAdapterjava 国 col i 
color.xml 
4 BB eduhrbeu.WeatherDemo.Weather ^ 
: 国 stringsxml 
b D Forecastjava 
- 4 & xml 
b 国 Weatherjava A 
g 国 apixml 
b E gen [Generated Java Files] " h k 
B AndroidManifestxml 
b BÀ Android 4.0 
a 国 proguard.cfg 
B assets lii project: ci 
rap roject. properties 
» & bin Lx E 


图 12.3  WeatherDemo 示例 的 源 代码 文件 


为 了 使 源 代码 文件 的 结构 更 加 清晰 ,WeatherDemo 示例 设置 了 多 个 命名 空间 ,分 别 
用 来 保存 用 户 界面 数据库、 后 台 服务 .SMS 短信 和 天 气 数据 的 源 代码 文件 ,命名 空间 的 


名 称 以 及 说 明 参 考 表 12. 3。 
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表 12.3. WeatherDemo 示例 的 命名 空间 


命名 空间 说 明 
edu. hrbeu. WeatherDemo 用 户 界面 相关 的 源 代码 文件 
edu. hrbeu. WeatherDemo. DB SQLite 数据 库 相 关 的 源 代码 文件 
edu. hrbeu. WeatherDemo. Service 后 台 服 务 相关 的 源 代码 文件 
edu. hrbeu. WeatherDemo. SMS SMS 短信 相关 的 源 代码 文件 


edu. hrbeu. WeatherDemo. Weather 


天 气 数据 有 关 的 源 代码 文件 


WeatherDemo 示例 将 不 同 用 途 的 源 代码 文件 放置 在 不 同 的 命名 空间 中 , 源 代码 文件 
的 名 称 和 用 途 可 以 参考 表 12. 4。 


表 12.4 WeatherDemo 示例 的 文件 用 途 说 明 


E 名 R 文件 名 说 明 

History Activity. java “历史 数据 ?页 的 Activity 
SetupActivity. java “系统 设置 "页 的 Activity 

. WeatherDemo = 
WeatherActivity. java “天 气 预 报 ” 页 的 Activity 
WeatherDemo. java 程序 启动 默认 的 Activity 
Config. java 配置 信息 的 类 

. WeatherDemo. DB 
DBAdapter. java 数据 库 适 配器 
SmsReceiver. java 短信 监听 器 

. WeatherDemo. Service WeatherAdapter. java 数据 获取 模块 
WeatherService. java 后 台 服 务 
SimpleSms. java 简化 的 SMS 短信 类 

. WeatherDemo. SMS - 
Sms Adapter. java 短信 发 送 模块 
Forecast. java 未 来 天 气 信息 的 类 

. WeatherDemo. Weather 一 
Weather. java 当前 天 气 信息 的 类 


Android 资源 文件 保存 在 /res 的 子 目 录 中 。 其 中 /res/drawable 目录 中 保存 的 是 图 
像 文 件 ,/res/layout 目录 中 保存 的 是 布局 文件 ,/res/values 目录 中 保存 的 是 用 来 定义 字 
符 串 和 颜色 的 文件 ,/res/xml 目录 保存 的 是 XML 格式 的 数据 文件 。 所 有 在 程序 开发 阶 
段 可 以 被 调用 的 资源 都 保存 在 这 些 目录 中 ,具体 每 个 资源 文件 的 用 途 可 以 参考 表 12. 5。 


表 12.5 资源 文件 名 称 与 用 途 


资源 目录 xo 件 说 上 明 
icon. png 图 标 文件 
drawble sunny. png 调试 用 的 天 气 图 片 
tab_history. png “历史 数据 ?页 的 图 标 
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a 
资源 目录 x d 说 明 
tab_setup. png “系统 设置 "页 的 图 标 
o ER “天 气 预报 页 的 图 标 
di ow mi “历史 数据 "页 ListActivity 的 每 行 数据 的 布局 
tab_history. xml “历史 数据 ”页 的 布局 
udi "em “系统 设置 "页 的 布局 
tab_weather xml — | “天 气 预 报 ” 页 的 布局 
color. xml 保存 颜色 的 XML 文件 
string. xml 保存 字符 串 的 XML 文件 
Em "m 从 Google 下 载 的 天 气 数据 文件 。 在 程序 运行 时 没有 
实际 作用 ,但 在 开发 过 程 中 可 以 让 读者 了 解数 据 格式 


在 定义 了 所 有 文件 和 类 的 用 途 后 ,下 一 步 将 依据 程序 模块 结构 图 (图 12. 2) ,按照 自 
底 向 上 的 顺序 对 每 个 模块 进行 详细 的 介绍 。 自 底 向 上 介绍 有 利于 理解 模块 之 间 的 调用 
关系 ,也 避免 了 在 介绍 上 层 模块 时 ,读者 不 了 解 所 调用 的 下 层 模 块 的 问题 。 


1232 数据 库 适 配器 


数据 库 适 配器 是 最 底层 的 模块 ,主要 用 于 封装 用 户 界面 和 后 台 服 务 对 SQLite 数据 
库 的 操作 。 数 据 库 适 配器 的 核心 代码 主要 在 DBAdapter. java 文件 中 ,在 介绍 数据 库 适 
配器 的 核心 代码 前 ,首先 了 解 一 下 用 户 保存 配置 信息 的 类 文件 Config. java。 

Config. java 文件 的 全 部 代码 如 下 。 


1 package edu.hrbeu.WeatherDemo.LB; 

2 

3 public class Config ( 

4 public static String CityName; 

5 public static String RefreshSpeed; 

6 public static String ProvidesmsService; 
7 public static String SavesmsInfo; 

8 public static String KeyWord; 

9 

10 public static void LoadDefaultConfig() ( 
1 CityName- "New York"; 

12 RefreshSpeed- "60"; 

13 ProvidesmsService- "true"; 

14 SavesmsInfo- "true"; 

15 KeyWord- "NY"; 

16 } 

17 i? 
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从 代码 中 不 难看 出 ,公有 静态 属性 CityName、RefreshSpeed、ProvideSmsService、 
SaveSmsInfo 和 KeyWord, 完 全 对 应 数据 库 中 保存 配置 信息 表 的 属性 (参照 表 12. 1)。 在 
程序 启动 后 ,保存 在 数据 库 中 的 城市 名 称 、 更 新 频率 .是 否 提供 短信 服务 .是 否 保存 短信 
信息 和 关键 字 等 内 容 , 将 被 读 取 到 这 个 Config 类 中 , 供 其 他 模块 做 逻辑 判断 时 使 用 。 

代码 第 10 行 的 LoadDefaultConfig() 函 数 , 保 存 了 程序 内 置 的 配置 参数 。 此 函数 会 
在 两 个 情况 下 被 调用 ,一 是 用 户主 动 选择 “恢复 默认 设置 ”; 二 是 首次 启动 程序 时 ,用 来 初 
始 化 保存 配置 参数 的 数据 库 。 

DBAdapter 类 与 以 往 介 绍 过 的 数据 库 适 配器 类 相似 ,都 具有 继承 SQLiteOpenHelper 的 
帮助 类 DBOpenHelper。DBOpenHelper 在 建立 数据 库 时 ,同时 建立 两 个 数据 库 表 ,并 对 
保存 配置 信息 的 表 进 行 了 初始 化 ,初始 化 的 相关 代码 在 第 42 一 第 49 行 。 


private static final String DB NAME- "weather app.db"; 
private static final String DB TABLE OONFIG- "setup config"; 
private static final String DB OONFIG ID- "1"; 

private static final int DB VERSION- 1; 


public static final String KEY ID-" id"; 

public static final String KEY CITY NAME= "city name"; 

public static final String KEY REFRESH SPFED- "refresh speed"; 
public static final String KEY SMS SERVICE- "ams service"; 

10 public static final String KEY SMS INFO- "ams info"; 

1l public static final String KEY KEY WORD= "key word"; 


13 private static final String IB. TABIE SMS- "ams data"; 

14 public static final String KEY SENDER- "ams sender"; 

15 public static final String KEY BODY- "sms body"; 

16 public static final String KEY RECEIVE TIME- "sms receive time"; 
17 public static final String KEY RETURN FESULT- "return result"; 


19 /x 静态 Helper 类 ,用 于 建立 、 更 新 和 打开 数据 库 * / 

20 private static class [BOpenHelper extends SQLiteOpenHelper { 

21 public DBopenHelper (Context context, String name, CursorFactory factory, int version) ( 
22 Super(context, name, factory, version); 

23 1 


25 private static final String DB CREATE CONFIG- "create table "+ 

26 IB TABLE CONFTGH " ("+ KEY ID+ " integer primary key autoincrement, "+ 
z KEY CITY NAME+ " text not null, "+ KEY REFRESH SPEED+ " text, "+ 

28 KEY SMS SERVICE+ " text, "-KEY SMS INFO+" text, "+ 


29 KEY KEY WORD+ " text);"; 
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30 

31 private static final String DB CREATE SMS- "create table "+ 

了 2 IB TARIE SMS+ "("+ KEY ID" integer primary key autoincrement, "+ 

3 KEY SENDERt" text not null, "- KEY BODY+ " text, "+ 

3 KEY RECEIVE TIME+ " text, "KEY RETURN RESULT" text);"'; 

35 

36 GoOverride 

3! public void onCreate (SüLiteDatabase db) ( 

38 . do.execSQL(DB CREATE OONFIG); 

39 .Gb.execSQL(DB CREATE SMS); 

40 

a // 初 始 化 系统 配置 的 数据 表 

42 Config.IoadDefaultConfig(); 

43 ContentValues newWalues- new ContentValues () ; 

44 newValues.put(KEY CTTY NAME, Config.CityName); 

45 new/alues.put(KEY REFRESH SPFED, Config.RefreshSpeed); 

46 newValues.put(KEY SMS SERVICE, Config.ProvideSmsServioe); 

4 newWalues.put(KEY SMS INFO, Config.SaveSmsInfo); 

48 newalues.put(KEY KEY WORD, Config.KeyWord); 

49  db.insert(IB TABLE OONFIG, null, new/alues); 

5 i 

5 

52 GOverride 

53 public void onüpgrade (SQLiteDatabase db, int oldVersion, int - 
newVersion)( 

54 . db.execSQL("TROP TABLE IF EXISTS "+ DB_TABIE CONFIG); 

55 . cb.execSQL("TROP TABLE IF EXISTS "+ DB CREATE SMS); 

56 onCreate( db); 

57 } 

58 } 


在 DBAdapter 类 中 ,用 户 界面 会 调用 SaveConfig() 和 LoadConfigO ,在 SQLite 数据 
库 中 保存 和 读 取 配 置信 息 。 保 存 配置 信息 时 .SaveConfig() 函数 会 将 Config 类 中 的 公 
静态 属性 写 和 人 数据库; 反之 ,LoadConfig() 会 将 数据 库 中 的 配置 信息 写 入 Config 类 中 的 
公有 静态 属性 。SaveConfig() 和 LoadConfig() 的 代码 如 下 。 


public void SaveConfig() ( 
ContentValues updateValues- new ContentValues () ; 
updateValues.put(KEY CITY NAME, Config.CityName); 
updateValues.put(KEY REFRESH SPEED, Config.RefreshSpeed) ; 
updateValues.put(KEY SMS SERVICE, Config.ProvideSmsService); 
updateValues.put(KEY SMS INEO, Config.SavesmsInfo); 


oO Uc wm oH 
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updateValues.put(KEY KEY WORD, Config.KeyWord); 
.poate (TB TRIE CONFIG, updateValues, KEY D+ = "+B QONFIG ID, null); 
Toast.makeText (context，" 系 统 设置 保存 成 功 " Toast.IENGTH SHORT) .show(); 


public void LoadConfig() ( 

Cursor result= db.query (DB TEIE ONFTG, new String[]( KEY ID, KEY CITY NYE, 
KEY REFRESH SPEED,KEY SMS SERVICE, KEY SMS INFO, KEY KEY WORD], 
KEY IDE'"- "TB OONFTG ID, null, null, null, null); 

if(result.getCount () - — 0 | | !result.moveToFirst ()) ( 

retum; 
} 

Config.CityName= result.getString (result.getColumIndex(KEY CTTY NAME)); 

Qnfig.RefreshSpeed result.getString (result .get ColimInde (EY FEFFESH SHEED)); 

Config.ProvideSmsService= result.getString(result.getColumIndex(KEY SB_ 

SERVICE)); 

Config.SaveSmeInfor result .getString (result .getoolumIndex (KEY SYS_INEO)); 

Config.Keyiiord- result .getString (result .getColumIndex (KEY KEY WORD)); 

Toast.makeText (context，" 系 统 设置 读 取 成 功 "，Toast.IENGTH SHORT) .show(); 


另 一 个 会 调用 DBAdapter 类 的 是 后 台 服 务 , 即 WeatherService 类 。 后 台 服 务 主 要 调 
用 SaveOneSms(SimpleSms sms) DeleteAllSms() 和 GetAllSms O PA% . 4 Jl FH ofc f f£ 
SMS 短信 记录 、 删 除 所 有 SMS 数据 记录 和 获取 所 有 SMS 数据 记录 。 在 GetAllSmsO PR 
数 中 ,调用 了 一 个 私有 函数 ToSimpleSms(Cursor cursor) ,用 来 将 从 数据 库 获 取 的 数据 


转换 为 SimpleSms 实例 数组 。SimpleSms 类 将 在 下 一 小 节 进 行 介绍 ,下 面 先 给 出 


SaveOneSms(SimpleSms sms) .DeleteAllSms() 和 GetAllSms O 函数 的 代码 。 


public void SaveOneSms (SimpleSms sms){ 
ContentValues newValues- new ContentValues () 7 
newValues.put(KEY SENDER, sms.Sender); 
new/alues.put(KEY BODY, sms.Body); 
newValues.put(KEY RECEIVE TIME, sms.ReceiveTime); 
newValues.put(KEY RETURN RESULT, sms.ReturmResult); 
do.insert(DB TABIE SMS, null, newValues); 


public long DeleteAllsms() ( 
retum db.delete(TB TABIE SMS, null, null); 
} 
public Simplesms[] GetAllSsms() { 
Cursor results= db.query (TB_TABIE SMS, new String[] ( KEY ID, KEY SENER, 
KEY BODY, KEY RECEIVE TIME, KEY RETURN FESULT), 
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null, null, null, null, null); 
return ToSimpleSms (results) ; 


private SimpleSms[] ToSimpleSms (Cursor cursor) { 


int resultCounts- cursor.getCount () ; 

if (resultCounts- - 01| !cursor.moveToFirst () ) ( 
return null; 

) 


Simple&ms[] sms- new Simple&ns [resultCounts] ; 
for(int i- 0 ; i< resultCounts; i++){ 
sms [i]- new SimpleSms () ; 
sms [i] .Sender- cursor.getString(cursor.getColumnIndex (KEY SENLER)); 
sms [i] .Body- cursor.getString (cursor.getColumIndex(KEY BODY)); 
sms [i] .ReceiveTime- cursor.getString (cursor.getColumIndex (KEY - 
RECEIVE TIME)); 
sms [1].ReturnResult- cursor.getString(cursor.getColumnIndex (KEY RETURN - 
RESULT) ; 
cursor.moveTcNext () ; 
) 
retum sms; 


1233 短信 监听 器 


短信 监听 器 本 质 上 是 BroadcastReceiver, 用 于 监听 Android 系统 所 接收 到 的 所 有 
SMS 短 消息 ,可 以 在 应 用 程序 关闭 后 仍然 继续 运行 ,核心 代码 在 SmsReceiver. java 文件 
中 。 同 样 在 介绍 SmsReceiver 类 前 , 先 说 明 用 来 保存 SMS 短信 内 容 和 相关 信息 的 
SimpleSms 类 。android. telephony. SmsMessage 是 Android 提供 的 短信 类 ,但 这 里 需要 
一 个 更 精简 ,小巧 的 类 ,保存 少量 的 信息 ,因此 构造 了 SimpleSms 类 , 仅 用 来 保存 短信 的 
发 送 者 、 内 容 、 接 收 时 间 和 返回 结果 。 这 里 的 “返回 结果 ” 指 的 是 返回 包含 天 气 信息 的 短 


信和 内容。 


SimpleSms. java 文件 的 完整 代码 如 下 所 示 。 


- o c 5€ 5-2 


package edu.hrbeu.WeatherDemo.SMS; 
import java.text.SimpleDateFormat; 


public class SimpleSms { 


public String Sender; 
public String Body; 
public String ReceiveTime; 
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public String ReturnFesult; 


public Simple&ms() ( 

) 

public SimpleSms (String sender, String body) ( 
this.Sender- sender; 
this.Body- body; 


SimpleDateFormat. tempDate- new SimpleDateFormat ("yyyy- M+- dd" " "+ "nhzm:ss") ; 


this.ReceiveTime- tempDate. format (new java.util.Date ()) ; 
this.ReturnResult- ""; 


$ 


代码 第 5 行 一 第 8 行 的 属性 Sender, Body, ReceiveTime 和 ReturnResult, 分 别 表示 
SMS 短信 的 发 送 者 、 内 容 、 接 收 时 间 和 返回 结果 。 代 码 的 第 15 行 和 第 16 行 在 
SimpleSms 类 的 构造 函数 中 ,直接 将 系统 时 间 以 “年 -月 -日 


ReceiveTime 属性 中 。 


SmsReceiver 类 继承 BroadcastReceiver, 重 载 了 onReceive() 困 数 。 系 统 消 息 的 识别 
和 关键 字 的 识别 并 不 复杂 ,只 要 接收 android. provider. Telephony. SMS. RECEIVED 类 
型 的 系统 消息 , 则 表明 是 Android 系统 接收 到 了 短信 。 将 短信 的 内 容 拆 分 后 ,判断 消息 
内 容 是 否 包含 用 户 定 义 的 关键 字 , 则 可 判断 该 短信 是 否 为 天 气 服务 请 求 短信 。 下 面 给 出 


SmsReceiver. java 文件 的 核心 代码 。 


小 时 :分 : 秒 ” 的 格式 保存 在 


1 
2 
3 
4 
5 
6 
7 
8 
9 


10 
u 
12 
13 
14 
15 
16 


public class SmsReceiver extends BroadcastReceiver( 
private static final String SMS ACTION- "android.provider.Telephony.SMS RECEIVED"; 


GOverride 
public void onReceive (Context context, Intent intent) ( 
if(intent.getAction().equals (SMS ACTION))( 
Bundle bundle- intent .getExtras () ; 
if(bundle!- null) ( 
Gbject[] bjs= (Cbject[]) bundle.get ("pius") ; 
SmeMessage[] messages- new SmsMessage [dbjs. length] ; 
for(int i- 0; i< dbjs.length; i++){ 
messages [i]- SmeMessage.createFrasPdu ((byte[]) dojs[i]) ; 
} 
String smsBody- messages [0] .getDi splayMessageBody () ; 
String smeSender- messages [0] .getDisplayoriginatingadriress () ; 
if (smsBody.trim() equals (Config.KeWord) && Config 
-ProvideSmsService.equals ("true") ( 
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n SimpleSms simpleSms- new SimpleSms (smsSender, smsBody); 

18 WeatherService.RequerSMSService (simpleSms) ; 

19 Toast.makeText (context, "接收 到 服务 请 求 短信 ", Toast. 
IENGTH SHORT) .show(); 

20 } 

21 } 

22 ) 

23 } 

24 } 


代码 第 9 行将 带 有 pdus 字符 串 特 征 的 对 象 ,通过 bundle. get O 函数 提取 出 来 ,并 在 
代码 第 12 行使 用 SmsMessage. createFromPdu O 函数 构造 SmsMessage 实例 。 在 代码 
第 12 行使 用 循环 语句 是 因为 接收 到 的 短信 可 能 不 止 一 条 ,但 从 第 14 行 和 第 15 行 代码 上 
看 ,这 里 只 处 理 第 1 条 短信 。 代 码 第 17 行 构造 SimpleSms 实例 ,然后 在 代码 第 18 行 调 
用 WeatherService 类 的 RequerSMSService () 函数 ,将 SimpleSms 实例 添加 到 短信 队 
列 中 。 

最 后 ,在 AndroidManifest. xml 文件 中 注册 短信 监听 器 SmsReceiver, 并 声明 可 接收 
短信 的 用 户 许可 android. permission. RECEIVE_SMS。 需 要 注意 的 是 ,如 果 注 册 的 组 件 
不 在 根 命名 空间 中 , 则 需要 将 子 命名 空间 写 在 类 的 前 面 ,例如 下 面 在 代码 第 1 行 中 ,因为 
SmsReceiver. java 文件 在 edu. hrbeu. WeatherDemo. Service 命名 空间 下 ,而 不 在 根 命名 
空间 edu. hrbeu. WeatherDemo 下 ,因此 注册 组 件 时 需要 在 类 名 SmsReceiver 前 添加 


. Service, 


« receiver android:name- ".Service.SmsReceiver" > 
« intent- filter» 
< action android:name- "android.provider.Telephony.SMS RECEIVED"/» 
< /intent- filter» 


< /receiver» 


ao c QI» PP 


< uses- permission android:name- "android.permission.RECEIVE SMS"/» 


1234 后 全 服务 

后 台 服 务 是 WeatherDemo 示例 的 核心 模块 ,在 用 户 启动 后 持续 在 后 台 运 行 ,直到 用 
户 手动 停止 服务 。 后 台 服 务 主 要 有 两 个 功能 ,一 是 发 送 包 含 天 气 信息 的 SMS 短信 (短信 
发 送 子 模块 ) ,二 是 周期 性 地 获取 Google 的 天 气 数据 (数据 获取 子 模块 ) 。 

l. 短信 发 送 子 模块 


后 台 服 务 在 单独 的 线程 上 运行 ,首先 调用 ProcessSmsList O 函数 ,检查 短信 队列 中 
是 否 有 需要 回复 的 短信 ,然后 调用 GetGoogleWeatherData O 函数 获取 天 气 数据 ,最 后 线 
程 暂 停 1 秒 ,以 释放 CPU 资源 。WeatherDemo 示例 后 台 服 务 的 核心 代码 在 WeatherService 
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„java 文件 中 ,下 面 是 线程 调用 函数 的 部 分 代码 。 


private static ArrayList« SimpleSms> smsList- new ArrayList< SimpleSms> (); 


private Runnable backgroudWork- new Runnable () ( 
GOverride 
public void run() ( 
try{ 
while(!Thread.interrupted()){ 
ProoessSmsList () ; 
GetGoogleWeatherData () ; 
Thread.sleep (1000) ; 
) 
} catch (InterruptedException e) ( 
e.printStackTrace() ; 
) 


ProcessSmsList O 函数 用 来 检查 短信 列表 smsList, 并 根据 Weather 类 中 保存 的 天 气 
数据 ,向 请 求 者 发 送 回复 短信 。WeatherService. java 文件 的 ProcessSmsList O 函数 代码 
如 下 所 示 。 


1 
2 
3 
4 
5 
6 
7 
8 
9 


private void ProcessSmsList () ( 
if(smsList.size()- — O)( 
return; 
) 
SmsManager smsManager- SmsManager .get Default () ; 
PendingIntent mPi- PendingIntent.getBroadcast (this, 0, new Intent (), 0); 
while (smsList.size()» 0) ( 
Simples sms- smslist.get (0); 
smsList.remove (0) ; 
smsManager.sendTextMessage (sms.Sender, null, Weather.GetSmsMsg() , 
mPi, null); 
sms.ReturnBesult- Weather.GetSmsMsg () ; 


SaveSmsData (sms) ; 


} 


发 送 短信 是 使 用 SmsManager 对 象 的 sendTextMessage() 方 法 ,该 方法 一 共 需 要 


5 个 参数 。 


第 1 个 参数 是 收 件 人 地 址 ,第 2 个 参数 是 发 件 人 地 址 ,第 3 个 参数 是 短信 正 


文 , 第 4 个 参数 是 发 送 服务 ,第 5 个 参数 是 送 达 服务 。sendTextMessage() 方 法 的 收 件 人 
地 址 和 短信 正文 是 不 可 为 空 的 参数 ,而 且 一 般 GSM 规范 要 求 短信 内 容 要 控制 在 70 个 汉 
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字 以 内 。 代 码 第 8 行 的 Weather. GetSmsMsg() ,用 来 获得 供 回 复 短信 使 用 的 天 气 信息 ， 
因为 考虑 到 短信 的 字数 限制 , 仅 返 回 当 天 和 未 来 一 天 的 天 气 状 况 。 下 面 分 别 给 出 
Weather. java 和 Forecast. java 文件 的 完整 代码 。 

Weather. java 文件 的 代码 如 下 。 


package edu.hrbeu.WeatherDemo.Weather; 
inport android.grarhics.Bitmap; 


1 

3 

4 public class Weather ( 

5 public static String city; 
6 public static String forecast date; 

7 public static String current date time; 
8 public static String current condition; 
9 public static String current temp; 


10 public static String current humidity; 

1 public static String current image url; 

12 public static Bitmap current imege; 

13 public static String current wind; 

14 

15 public static Forecast[] day- new Forecast [4]; 
16 

17 static ( 

18 for(int i-0; i«day.length; i++){ 

19 day [i]- new Forecast () ; 

20 ) 

2 i 

22 

23 public static String GetSmsMsg () ( 

24 String msg- ""; 

25 msgt - cityt ","; 

26 msg+ = current condition*", "+ current temp*". "; 
z msg*- day[0].day of weekt", "+ day[0] .conditiont ", "+ 
28 day[0] -high "/"+ day [0] .low; 
29 return msg; 

30 ) 

3 ] 
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5 public String day of week; 
6 public String low; 

3 public String high; 

8 public String image url; 

9 public Bitmep image; 

10 public String condition; 


2. 数据 获取 模块 


天 气 数据 是 从 Google 提供 的 Web Service 中 获取 的 ,调试 WeatherDemo 示例 时 需 
要 网 络 环境 ,数据 的 获取 地 址 是 http://www. google. com/ig/api? hl = en&-weather = 
New%20York。 其 中 ,New%20York 表示 获取 纽约 (New York) 的 天 气 数 据 ,% 20 表示 
一 个 空格 。 读 者 可 以 将 上 面 提供 的 地 址 输入 到 Web 浏览 器 ,在 浏览 器 中 直接 看 到 XML 
格式 的 天 气 数据 。 

在 资源 目录 中 的 /res/xml/api. xml 文件 ,就 是 2009 年 9 月 22 日 获取 的 纽约 天 气 数 
据 。 在 程序 资源 中 保留 api, xml 文件 ,主要 是 用 来 帮助 读者 分 析 XML 数据 格式 ,在 程序 
运行 期 间 并 不 访问 该 文件 。api. xml 文件 的 内 容 如 下 。 


1 <?xml version "1.0" encoding- "UTF- 8"?> 

2 «ml api reply version- "1"> 

3 «weather module id- "0" tab id- "0" mobile row- "0" mbile zipped- "1" row- "0" section 
="0> 

4 «forecast information» 

5 < city data= "New York, NY"/> 

6 «postal code data- "New York"/> 

7 «latitude e6 data= ""/> 

8 «longitude e6 data= ™"/> 

9 < forecast. date data= "2009- 09- 22"/> 

10 «current date time data= "2009- 09- 22 16:51:00 0000"/> 

u «unit system data= "US"/> 

12 < /forecast_infommtion> 

13 

14 «current conditions» 

15 < condition data= "Mostly Cloudy"/» 

16 «temp f data= "72"/> 

17 «temp c data= "22"/> 

18 « humidity data= "Himidity: 71$"/» 

19 < icon data- "/ig/images/weather/mostly cloudy.gif"/» 

20 «wind condition data= "Wind: N at 6 nph"/» 

21 < /current. conditions» 

22 
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23 < forecast conditions» 
24 «day of week data- "Tue"/> 

25 < low data- "65"/» 

26 X high data- "76"/> 

2] < icon data- "/ig/images/weather/mostly sunny.gif"/» 
28 < condition data= "Partly Sunny"/» 

29 < /forecast conditions» 

30 

31 < forecast conditions» 

3 «day of week data- "Wed"/> 

33 < low data- "68"/> 

3 «high data= "79"/» 

35 < icon data- "/ig/images/weather/chance of stom.gif"/» 
36 < condition data= "Chance of Storm"/» 

3] « /forecast conditions» 

38 

39 < forecast conditions» 

40 «day of week data- "Thu"/> 

4l < low data- "61"/» 

42 «high data= "83"/> 

43 < icon data- "/ig/images/weather/chance of storm.gif"/> 
44 < condition data= "Chance of Storm"/> 

45 < /forecast conditions» 

46 

4 « forecast conditions» 

48 «day of week data= "Fri"/» 

49 < low data "54"/» 

50 «high data- "72"/> 

51 < icon data- "/ig/images/weather/sunny.gif"/> 

52 < condition data= "Clear" /> 

53 < /forecast conditions» 

54 < /weather> 

55  «/xml api reply> 


二 forecast_information 记 标签 内 的 数据 是 天 气 预报 的 城市 和 时 间 等 基本 信息 ， 
< 到 current_conditions 二 标签 内 的 是 当时 的 天 气 状 况 ,4 A< forecast. conditions ^ bs 4€ Jé 
未 来 4 天 的 天 气 情况 。 在 api. xml 文件 中 ,还 提供 了 能 够 反映 天 气 情况 的 图 标 地 址 ,例如 
第 19 行 .第 27 行 和 第 35 行 等 。 

WeatherAdapter 类 实现 了 利用 URL 获取 位 图 的 私有 函数 GetURLBitmap() ,以 及 
用 来 下 载 和 解析 XML 数据 的 公有 函数 GetWeatherData()。 后 台 服 务 在 调用 
GetWeatherData O 函数 解析 Google 提供 的 天 气 数据 时 ,会 不 断 调用 GetURLBitmap() 
函数 ,将 XML 数据 中 的 天 气 图 标 根据 图 标 地 址 下 载 到 本 地 保存 。GetURLBitmap() PR 
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数 的 代码 如 下 所 示 。 
1 private static Bitmap GetURIBitmap (String urlString) { 
2 URL url- null; 
3 Bitmap bitmap- null; 
4 uyt 
5 url= new URL ("http: //www.google cam" urlString) ; 
6 ) 
T catch (MalformedqDRIException e) ( 
8 e.printStackTrace () ; 
9 ) 
10 
u try{ 
12 HttpURIConnection conn- (HttpURIConnection) url.openConnection(); 
13 conn.connect () ; 
14 InputStream is- conn.getInputStream() ; 
15 bitmap- BitmapFactory.decodeStream (is) ; 
16 is.close(; 
17 Jcatch (IGException e) ( 
18 e.printStackTrace () ; 
19 } 
20 return bitmap; 
2 } 


第 12 行 代码 构造 了 支持 HTTP 功能 的 URLConnection ,连接 后 在 第 14 行 返回 字 节 


流 ,第 15 行使 用 字 节 流产 生 位 图 ,最 后 在 第 16 行 关 闭 字 节 流 。 


GetWeatherData O 函数 首先 根据 指定 的 URL 地 址 ,从 网 络 获取 字 节 流 数据 ,然后 调 
用 轻 量 级 XML 解析 器 XmlPullParser 对 天 气 数 据 进行 解析 ,并 将 解析 结果 保存 在 


Weather 类 的 公有 静态 属性 中 。GetWeatherData() 函数 的 代码 如 下 。 


1 public static void GetWeatherData() throws IOException, Throwable { 

2 String queryString- "http: //www.google.cam/ig/api? weather- "+ Config. 
CityName; 

3 URL aURL- new URL (queryString.replace(" ", "$20")); 

4 URLConnection conn- aURL.cpenConnection () ; 

5 conn.connect () ; 

6 InputStream is- conn.getInputStream() ; 

1 

8 XmlPullParserFactory factory- XmlPullParserFactory.newInstance () ; 

9 factory.setNamespacezZware (true); 

10 XmlPullParser parser- factory.newPullParser(); 

u parser.setInput (is, "UIF- 8"); 

12 
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int dayCounter= 0; 
while (parser .next () != XimlPullParser.FND DOCUMENT) { 


String element- parser.getName () ; 
if(element!- null && element.eqguals("forecast information"))( 
while(true)( 
int eventCode- parser.next () ; 
element- parser.getName () ; 
if(eventCode- = XmlPullParser.START TAG)( 
if(element.equals ("city") ) ( 
Weather.city- parser.getAttributeValue (0) ; 
Jelse if (element.equals ("current date time"))( 
Weather.aurent. date time- parser.getAttributevalue (0) 


if(element.equals ("forecast information") && 
eventCode- = XmlPullParser.END TAG)( 
break; 


) 
if(element!- null && element.eguals ("current conditions"))( 
while (true) { 
int eventCode= parser.next () ; 
element- parser.getName () ; 
if(eventCode- = XmlPullParser.START TAG)( 
if (element .equals ("condition") ) { 
Weather.current. acriiticn- parser.getAttributeValue (0); 
Jelse if (element.equals ("temp £"))( 
Weather.current temp- parser.getAttributeValue (0) ; 
Jelse if (element.equals ("humidity")) ( 
Weather.current humidity- parser.getAttributeValue (0) ; 
Jelse if (element.equals ("wind condition"))( 
Weather.current wind- parser.getAttributeValue (0) ; 
Jels if (element equals ("icon") ) ( 
Weather.current image url-parser.getAttributeValue (0); 
Weather.current image- GetURIBitmap (Weather.current | 
image url); 
$ 
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if(element.eguals ("current conditions") && 
eventOode- = Xml PullParser.END TAG)( 
break; 


) 
if(element!- null && element.equals("forecast conditions"))( 
while (true) { 
int eventCode- parser.next () ; 
element- parser.getName () ; 
if(eventCode- = XmlPullParser.START TA)( 
if(element.equals ("day of week"))( 

Weather.day[dayCounter].day of week- parser. 
getAttributeValue (0) ; 

Jelse if (element equals ("10w") ( 
Weather.day [dayCounter] .1ow- parser. 
getAttributeValue (0) ; 

Jelse if (element equals ("high") ) ( 
Weather.day [dayCounter] .high- parser. 
getAttributeValue (0) ; 

Jelse if (element..equals ("icon") ) ( 

Weather.day [dayCounter].image url- parser. 
getAttributeValue (0) ; 
Weather.day [dayCounter] .image= GetURL Bitmap (Weather.day 

[dayCounter].image url); 

Jelse if (element.equals ("condition") ( 

Weather.day [dayCounter] .condition- parser. 
getAttributeValue (0) ; 

) 


if (element .equals ("forecast conditions") && 
eventOode- = XmlPullParser.END TAG)( 
dayCounter* + ; 
break; 
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最 后 ,在 AndroidManifest. xml 文件 中 注册 WeatherService, 并 声明 两 个 用 户 许可 : 
连接 互联 网 和 发 送 SMS 短信 。 


1 < service android:name- ".Service.WeatherService"/» 
2 < uses- permission android:name- "android.permission.INTERNET"/» 
3 < uses- permission android:name- "android.permission.SEND SMS"/» 


12335 用 户 界面 


在 用 户 界面 设计 上 ,采用 可 多 分 页 快速 切换 的 TabHost 控件 。WeatherDemo 示例 
TabHost 控件 的 每 个 标签 页 与 一 个 Activity 相关 联 ,这 样 就 可 以 将 不 同 标签 页 的 代码 放 
在 不 同 的 文件 中 ,而且 每 个 标签 页 都 可 以 有 独立 的 选项 菜单 。 

WeatherDemo 类 是 继承 TabActivity 的 Tab 标签 页 , 共 设 置 3 个 标签 页 。 第 一 个 标 
签 页 TABI 的 标题 为 “天 气 预 报 ”, 关 联 的 Activity 为 WeatherActivity; 第 二 个 标签 页 
TAB2 的 标题 为 “历史 数据 ,关联 Activity 为 HistoryActivity, 第 三 个 标签 页 TAB2 的 标 
题 为 “系统 设置 ” ,关联 Activity 为 SetupActivity。 

WeatherDemo. java 文件 的 完整 代码 如 下 。 


package edu.hrbeu.WeatherDemo; 


1 
2 

3 — import android.app.TabActivity; 
4 inport android.content.. Intent; 
5 import android.os.Purdle; 

6 import android.widget.TabHost; 
M 

8 

9 


public class WeatherDemo extends TabActivity { 


GOverride 
10 public void onCreate (Bundle savedInstanceState) { 
AY Super.onCreate (savedInstanceState) ; 
12 
13 TabHost tabHost- get'TabHost () ; 
14 tabHost .ackiTab (tabHost .newTabSpec ("TABI") 
15 .setIndicator ("KA HHR", getRescurces () .getDreweble (R. dreweble.tab 
 weather)) 
16 .setContent (new Intent (this, WeatherActivity.class))); 
17 
18 tabHost .acdTab (tabHost .newTabSpec ("IAB2") 
19 -setIndicator ("历史 数据 ",getResouroes () .getDrawable (R.drawable.tab history)) 
20 -setContent (new Intent (this, HistoryActivity.class))); 
2 
2 tabHost .acdTab (tabHost .newTabSpec ("TAB3") 
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23 .setIndicator(" 系 统 设 置 "getResoumoes () .getDrawsble (R.drawsble.tab | 
setup)) 

24 -setContent (new Intent (this, SetupActivity.class))); 

25 ) 

26 } 


WeatherDemo. java 中 的 代码 只 是 用 户 界面 的 框架 ,设置 了 Tab 标签 页 的 图 标 、 标 题 
和 所 关联 的 Activity ,标签 页 中 的 具体 显示 内 容 还 要 依赖 于 每 个 Activity 所 设置 的 界面 
布局 。 下 面 就 分 别 介 绍 WeatherActivity、HistoryActivity 和 SetupActivity。 


1. WeatherActivity 


WeatherActivity 主要 用 来 显示 天 气 信 息 。WeatherActivity 在 启动 时 并 不 能 直接 显 
示 最 新 的 天 气 信息 ,用 户 需 要 通过 选项 菜单 的 “启动 服务 ”开启 后 台 服 务 , 然 后 点 击 “ 刷 
新 ?获取 最 新 的 天 气 状况 ,此 时 界面 显示 的 内 容 如 图 12.4 所 示 。 此 外 ,选项 菜单 还 提供 
“停止 服务 "和 “退出 ”选项 。 

WeatherActivity 使 用 的 布局 文件 是 tab. weather. xml, 这 是 一 个 较为 繁琐 的 界面 布 
局 ,多 次 使 用 了 垂直 和 水 平 的 线性 布局 。WeatherActivity 的 界面 布局 和 代码 并 不 难以 理 
解 ,因此 这 里 不 再 给 出 WeatherActivity. java 和 tab_weather. xml 的 具体 代码 。 


2. HistoryActivity 


HistoryActivity 主要 用 来 显示 SQLite 数据 库 中 的 短信 服务 信息 ,显示 的 内 容 包 括 
发 送 者 的 手机 号 码 .时 间 和 回复 短信 内 容 , 如 图 12.5 所 示 。 为 了 能 够 以 列表 的 形式 显示 


E WeatherDemo 


10:00 +0000 


12.4  WeatherActivity 用 户 界面 Æ 12.5 HistoryActivity 用 户 界面 
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多 行 数据 ,并 且 定 制 每 行 数据 的 显示 布局 ,这 里 使 用 了 以 往 章节 没有 介绍 过 的 
ListActivity( Android. app. ListActivity) 。 

ListActivity 可 以 不 通过 setContentView() 设 置 布 局 ,也 不 必 重 载 onCreate() 函数 ， 
而 直接 将 显示 列表 加 载 到 ListActivity, 增 加 了 使 用 的 便利 性 。 在 WeatherDemo 示例 中 ， 
仍然 使 用 setContentView() 设 置 布局 ,这 样 做 的 好 处 是 可 以 在 界面 中 设置 更 为 复杂 的 显 
示 元 素 , 例 如 在 列表 上 方 增加 了 提示 信息 “SQLite 数据 库 中 的 短信 服务 信息 ”。 下 方 的 代 
码 是 HistoryActivity. java 文件 onCreate( ) 函 数 中 设置 布局 和 加 载 适 配器 的 关键 代码 。 


1 setContentView(R.layout.tab history); 
2 setListAdapter (dataAdapter) ; 


tab_history. xml 是 HistoryActivity 的 布局 文件 ,下 面 先 分 析 一 下 tab_history. xml 
的 内 容 。tab_history. xml 文件 的 完整 代码 如 下 。 


1 <?xml version- "1.0" encoding- "utf- 8"?» 

2  «Linearlayout xmins:android- "http: //schemas android. ocn/apk/res/android" 
3 ardroid:orientation- "vertical" 

4 android:layout width= "fill parent" 

5 android:layout height- "fill parent" 

6 android:background- "@drawable/black"> 

1 
8 
9 


< TextView android:layout width- "wrap content" 
android:layout height- "wrap content" 


10 android:text- "SQLite 数据 库 中 的 短信 服务 信息 : "> 
u < /TextView> 

12 « ListView android:id- "Gandroid:id/list" 

13 android:layout width- "fill parent" 

14 android:layout height- "wrap content" 

15 android:layout marginTop= "2dip"> 

16 < /ListView> 


17  «/Linearlayout^ 


tab, history. xml 在 代码 的 第 12 一 第 16 行使 用 了 ListView 控件 ,并 定义 其 系统 ID 
Í& Jy (9 android: id/list. ListView 的 数据 适配器 是 通过 setListAdapter(dataAdapter) 设 
置 的 。ListView 使 用 的 是 自 定义 布局 ,布局 保存 在 data. row. xml 文件 中 ,data_row. xml 
的 完整 代码 如 下 所 示 。 


< LinearTayout xmins:android- "http://schemas.android.cayapkyres/androidn 
android:orientation- "horizontal" 
android:layout width- "fill parent" 
android:layout height- "fill parent" 
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5 android:background- "édrawable/white" 

6 android:layout margirfTop- "2dip"> 

3 

8 < Linearlayout android:orientation- "vertical" 

9 android:layout width- "fill parent" 

10 android:layout height- "fill parent" 

1l 

12 < TextView android:id- "@+ id/data row 01" 
13 android:layout gravity- "center vertical" 
14 android:layout width- "fill parent" 

15 android:layout height- "wrap content" 
16 android:textSize- "l?dip" 

17 android:textColor- "Gdrawable/black"/» 
18 

19 < TextView android:id- "@+ id/data row 02" 
20 android:layout gravity- "center vertical" 
2 android:layout width= "fill parent" 

2 android:layout height- "wrap content" 
23 android:textSize- "l?dip" 

24 android:textColor= "Gdrawable/black" 
25 android:layout margirilop- "3dip"/» 

26 < /Linearlayout^ 

27  «/Linearlayout^ 


Android 提供 的 数据 适配器 仅 允 许 保 存 字 符 串 数组 或 列表 对 象 , 如 果 和 希望 使 用 自 定 
义 布 局 , 则 需要 实现 自 定义 的 数据 适配器 ,并 继承 Android 提供 的 BaseAdapter 
(Android. widget. BaseAdapter) 对 象 。 自 定义 的 数据 适配器 在 SmsAdapter. java 文件 


中 ,其 完整 代码 如 下 。 
1 package edu.hrbeu.WeatherDemo.SMS; 
2 
3 import android.content.Context; 
4 inport android.view.layoutInflater; 
5 inport android.view.View; 
6 inport android.view.ViewGroup; 
7 inport android.widget .BaseAdapter; 
8 inport android.widget.TextView; 
9 import edi.hrbeu.WeatherDem.TB DEA dapter; 
10 import edu.hrbeu.WeatherDemo.R; 
nu 
2 
13 public class Smsadapter extends BaseAdapter{ 
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14 private IayoutInflater mInflater; 

15 private static DBAdapter dbAdapter ; 

16 private static SimpleSms[] smsList ; 

17 

18 public SmsZdapter (Context context) ( 

19 mInflater= Layout Inflater.fram (context) ; 
20 dbmqapter= new DBRGapter (context) ; 
2l Ghedapter.cpen (); 

2 smsList- doAdapter.GetAl18ms ()7 

23 ) 

24 

25 public static void RefreshData () ( 

26 smsList- doMapter.GetAllsms (); 

27] ] 

28 GOverride 

29 public int getCount () ( 

30 if(smsList-- null) 

3 retum 0; 

32 else 

33 return smsList.length; 

34 } 

35 GOverride 

36 public Object getItem(int position) ( 
37 if(smsList-- null) 

38 retum 0; 

39 else 

40 retum smsList [position]; 

a } 

42 GOverride 

43 public long getItemId(int position) ( 
44 return position; 

45 ) 

46 

4 QOverride 

48 public View getView(int position, View convertView, ViewGroup parent) { 
49 ViewHolder holder; 

50 if(convertView- — null) ( 

5l convertView-mInflater.inflate(R.layout.data row, null); 
5 holder- new ViewHolder(); 


53 holder.textRowOl- (TextView) convertView.findViewById(R.id.data row 01); 
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54 holder.textRow02- (TextView) convertView.findViewById(R.id.data row 02); 
55 convertView.setTag (holder) ; 

56 ) 

57 else( 

58 holder- (ViewHolder) convertView.getTag() 7 

59 i 

60 

6l if(smsList!- null) ( 

e String row0lMsg- "( "+ positiont ") "+" Az 3X 44 : "+ smsList 


[position] .Sender+ ", "+ smsList [position] .ReceiveTime; 


63 holder.textRow0l.setText (rowO1Msg) ; 

64 holder.textRow02.setText (smsList [position] .ReturmResult) ; 
€5 ) 

66 return convertView; 

67 ) 

68 

69 private class ViewHolder( 

70 TextView textRow0l; 

1 TextView textRow027 

72 } 


继承 BaseAdapter 类 要 重 载 4 个 函数 ,包括 getCount() 、getItem() , getItemId O f 
getView()。LayoutInflater 是 将 XML 文件 中 的 布局 映射 为 View 对 象 的 类 ,在 代码 第 
14 行进 行 了 声明 ,在 代码 第 51 行 ,将 data. row. xml 文件 映射 为 View 对 象 。 代 码 第 
70 行 和 第 71 行 的 内 容 ,需要 对 应 data. row. xml 文件 中 的 
界面 元 素 。 


3. SetupActivity 


SetupActivity 主要 用 来 保存 和 恢复 用 户 设置 的 运行 

参数 ,第 一 次 启动 或 恢复 默认 设置 (在 选项 菜单 中 ) 后 ,界面 
上 会 显示 系统 的 默认 设置 ,包括 城市 名 称 、 更 新 频率 、 是 否 

提供 短信 服务 、 是 否 记 录 短信 服务 数据 信息 和 短信 服务 的 
关键 字 。SetupActivity 用 户 界面 如 图 12.6 所 示 。 

在 SetupActivity. java 文件 中 ,主要 功能 集中 在 
RestoreDefaultSetupO , UpdateUI (O) fll SaveConfig() 三 个 
PRX E. RestoreDefaultSetup C) 用 来 恢复 系统 的 默认 配 
E ; Update UI O 会 根据 保存 在 Config 类 中 的 数据 更 新 
SetupActivity 的 界面 控件 ,SaveConfig() 根 据 界面 配置 更 图 12.6 SetupActivity 用 户 界面 
ilt Config 类 ,然后 调用 数据 库 适 配器 的 DBAdapter. SaveConfig() 函 数 , 将 Config 类 中 的 


应 用 系统 设置 取消 系统 设置 
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配置 数据 写 人 数据 库 。 


private void RestoreDefaultSetup() ( 
Config.LoadDefaultConfig() ; 
UpdateUI () ; 
dbzdapter.SaveConfig() ; 


private void UpdateUI () ( 
cityNameView.setText (Config.CityName); 
refreshSpeedView.setText (Config.RefreshSpeed) ; 


10 snsServioeView.setChecked (Config. Provide&msService.equals ("true") ? 
true:false); 

1l saveSmsInfoView.setChecked (Config.SaveSmsInfo.equals ("true") ? true: 
false); 

12 keyWorkView.setText (Config.KeyWord) ; 

i3. } 

14 

15 private void SaveConfig() ( 

16 Gonfig.CityName- cityNameView.getText () .toString () .trim() ; 

17 Gonfig.RefreshSpeed- refreshSpeedView.getText () .toString () ; 

18 if (smsServiosView.isChecked()) ( 

19 Config.ProvideSmsService- "true"; 

20 Jelse{ 

2 Config. ProvideSmsService- "false"; 

2 ) 

23 if (saveSmsInfoView.isChecked()) { 

24 Config.SavesmsInfo- "true"; 

25 ) 

26 else{ 

27 Config.SaveSmsInfo- "false"; 

28 ) 

29 Config.KeyWord- keyWorkView.getText () .toString () .trim(); 

30 dozdapter.SaveConfig () ; 

3 ] 


最 后 ,为 了 使 所 有 定义 的 Activity 和 ListActivity 生效 ,在 AndroidManifest. xml X. 
件 中 注册 所 有 定义 的 组 件 。 


工 «activity android:name- ".WeatherDemo" 
2 android:label- "@string/app name" 
< intent- filter» 
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< action android:name- "android. intent .action.MAIN"/» 
< category android:name- "android. intent category .LAUNCHER"/»- 
< fintent- filter» 
< /activity> 
< activity android:name- " WeatherActivity"/» 


o 0o -0 wm 


< activity android:name- ".HistoryActivity"/» 
10 «activity android:name- ".SetupActivity"/» 


Z Es 


本 章 的 综合 示例 使 用 TabHost 和 TabActivity 来 实现 Tab 导航 栏 ,尝试 使 用 操作 栏 
和 Fragment 实现 该 示例 。 


附录 A 


Android 虚拟 设备 


Android 虚拟 设备 (AVD) 能 够 通过 Android 命令 行 工 具 进行 管理 ,包括 AVD 的 创 
建 、 删 除 、 移 动 和 更 新 等 。 表 A. 1 给 出 了 AVD 的 管理 命令 及 其 参数 说 明 。 


表 A.1 AVD 管理 命令 
*$ € 9 HU 说 — m" & È 
android list 生成 一 个 系统 映像 的 target 
targets 清单 
显示 所 有 已 知 的 AVD, 内 容 
android list avds 包括 AVD 的 名 称 、 路 径 和 
外 观 等 
-n <name> AVD 名 称 建立 AVD 的 必 备 参数 


android 


create avd 


-t <targetID> 


Android 系统 映像 ID 


使 用 android list targets fir 
令 获 取 Android 系统 映像 的 
ID 列表 


-c <path> 或 
-c <size>[K|M] 


SD 卡 映像 文件 路 径 或 
SD 卡 映 像 的 容量 


示例 1: -c path/to/sdcard 
示例 2: -c 1000M 


如 果 新 建立 AVD 与 已 有 
AVD 的 名 称 相 同 ， 则 
Android 工具 将 提示 “AVD 
已 经 存在 ”, 自 动 停止 AVD 


2 PAEL AVD 的 创建 过 程 。 使 用 该 参数 ， 
Android 工具 将 自动 删除 已 
有 同名 AVD, 并 建立 新 
的 AVD 

m 保存 AVD 文件 和 目录 的 


位 置 


-s <name> 或 -s< 
width>-<height> 


指定 AVD 的 外 观 ,利用 外 
观 名 称 或 长 宽 进行 选择 


示例 1: -s HVGA-L 
示例 2: -s 320x240 


-a- snapshot 


在 AVD 中 放置 一 个 快照 
交 件 


-b<abi> 


默认 是 自动 选择 ABI, 如 果 
台 只 有 一 个 ABI 系统 映像 
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续 表 
a e $ 数 说 明 备 # 
aoid -nsCüsine AVD 名 称 删除 AVD 的 必 备 参数 
delete avd 
-n <name> AVD 名 称 移动 AVD 的 必 备 参数 
eie -p «path 移动 后 的 AVD 位 置 
move avd 
-r <rname> AVD 的 新 名 称 
修改 Android 虚拟 设备 ,使 
-update avd 其 与 文件 夹 下 的 新 SDK 
匹配 
修改 Android 工程 (必须 已 
-update project 经 有 一 个 AndroidManifest. 
xml X fF) 
android 为 一 个 测试 包 修改 Android 


update avds 


-update test-project 


工程 (必须 已 经 有 一 个 
AndroidManifest xml X ff) 


-update lib-project 


修改 Android 库 工程 (必须 已 
经 有 一 个 AndroidManifest. 
xml 文件 ) 


-update adb 


修改 adb 来 支持 USB 设备 


-update sdk 


修改 sdk 


emulator 


运行 新 创建 的 AVD 


示例 : emulator-avd WVGA- 
800-scale 96dpi-dpi- 
device 160 


使 用 标准 的 Android 系统 映像 创建 AVD Ht, Android 工具 允许 用 户 选择 虚拟 设备 
所 支持 的 硬件 列表 , 表 A. 2 列举 了 可 以 选择 的 硬件 及 其 默认 值 。 同 时 ,用 户 也 可 以 在 
AVD 的 config. ini 文件 中 找到 相关 的 硬件 选择 设置 。 


表 A.2 虚拟 设备 硬件 列表 


特 征 Ho R 属 性 
RAM 设备 容量 | 物理 RAM 容量 ,单位 为 兆 , 默 认 值 为 96 hw. ramSize 
触摸 屏 设备 是 否 支持 触摸 屏 ,默认 支持 hw. touchScreen 
轨迹 球 设备 是 否 支 持 轨 迹 球 .默认 支持 hw. trackBall 
QWERTY 键盘 | 设备 是 否 支 持 QWERTY 键盘 ,默认 支持 hw. keyboard 
DPad ftt 设备 是 否 支持 DPad 键 ,默认 支持 hw. dPad 
GSM 调制 解 调 器 | 设备 是 否 支持 GSM 调制 解 调 器 ,默认 支持 ”| hw.gsmModem 
摄像 头 设备 是 否 支持 摄像 头 , 默 认 不 支持 hw. camera 
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特 征 do R 属 性 
21 Pdf g 默认 值 为 640 hw. camera, maxHorizontalPixels 
pide E 默认 值 为 480 hw. camera, maxVerticalPixels 
GPS 设备 是 否 支持 GPS, 默 认 支 持 hw. gps 
电池 设备 是 否 支持 电池 ,默认 支持 hw. battery 
加 速度 计 设备 是 否 支持 加 速度 计 设备 ,默认 支持 hw. accelerometer 
录音 设备 是 否 支持 录音 ,默认 支持 hw. audioInput 
声音 回放 设备 是 否 支持 声音 回放 ,默认 支持 hw. audioOutput 
SD 卡 设备 是 否 支持 虚拟 的 SD 卡 , 默 认 支 持 hw. sdCard 
缓存 分 区 是 否 在 设备 中 使 用 缓存 分 区 ,默认 使 用 disk. cachePartition 
缓存 分 区 容量 默认 值 为 66MB disk. cachePartition. size 
LCD 密度 设置 AVD 屏幕 使 用 的 密度 ,默认 值 是 160 | hw. led. density 
轨迹 球 是 否 有 轨迹 球 hw. trackBall 
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Android API 


E 名 9 说 明 
android 包含 了 标准 Android 应 用 使 用 的 资源 类 
当 AccessibilityEvent 事件 被 启动 后 ,后 台 运 行 的 AccessibilityService 会 
android. 


accessibilityservice 


接收 回调 函数 ,这 些 事件 指 的 是 在 用 户 接口 间 的 状态 转换 ,如 焦点 变化 、 
按钮 被 点 击 等 


android. accounts 


直接 通过 统计 管理 器 访问 管理 的 统计 


android. animation 


提供 视图 切换 时 显示 动画 效果 的 类 


android. app 


封装 了 全 部 Android 应 用 模型 的 高 级 类 


android. app. admin 


提供 系统 级 的 设备 管理 功能 ,允许 创建 企业 级 安全 的 应 用 


android. app. backup 


包含 可 以 对 应 用 进行 备份 和 恢复 的 功能 


android. appwidget 


Android 允许 应 用 程序 发 布 嵌入 到 其 他 应 用 程序 中 的 视图 。 这 些 视 图 被 
称 为 窗口 部 件 , 由 AppWidget providers 发 布 。 可 以 包含 窗口 部 件 的 部 件 
被 称 为 AppWidget host 


android. bluetooth 


管理 蓝牙 功能 的 类 ,例如 扫描 设备 ,连接 设备 ,管理 两 个 设备 间 数 据 传输 


android. content 


包含 了 用 来 在 设备 上 访问 和 发 布 数据 的 类 , 它 包 含 三 个 主要 类 别 的 APIs 


android. content. pm. 


包含 了 用 来 访问 应 用 程序 软件 包 信 息 的 类 ,其 中 包括 它 的 行为 .权限 、 服 
务 、 签 名 和 供应 商 等 信息 


android. content. res 


包含 了 用 来 访问 应 用 程序 资源 的 类 ,比如 原始 的 有 价值 的 文件 .颜色 、 可 
绘 区 .多 媒体 或 者 包 中 的 其 他 文件 ,还 有 影响 到 应 用 程序 如 何 表现 的 重 
要 的 设备 配置 信息 (如 位 置 .输入 类 型 等 ) 


android. database 


包含 用 来 探究 通过 内 容 提 供 商 返回 的 数据 的 类 


android. database. sqlite 


包含 了 SQLite 数据 库 管理 类 ,应 用 程序 可 以 用 它 来 管理 自己 的 私有 数 
据 库 


android. drm 


提供 管理 DRM 内 容 和 确定 DRM 插件 (代理 ) 的 功能 的 类 


android. gesture 


提供 用 于 手势 识别 功能 的 类 


android. graphics 


提供 了 低级 别 的 图 形 工具 ,比如 画布 .颜色 过 滤器 ,点 和 矩形 ,可 以 对 屏幕 
绘图 进行 直接 控制 
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续 表 
说 明 


android. 


graphics. drawable 


提供 了 管理 只 用 来 显示 的 多 种 视觉 元 素 的 类 ,比如 位 图 和 斜率 


android. 


graphics. 


drawable. shapes 


包含 了 用 来 绘制 几何 图 形 的 类 


android, hardware 提供 对 可 能 并 不 是 每 台 Android 设备 都 具有 的 硬件 设备 的 支持 
android, hardware, usb 提供 对 硬件 设备 中 USB 设备 支持 的 类 


android. 


inputmethodservice 


写 人 方法 的 基础 类 


android. location 定义 了 Android 基于 位 置 的 和 相关 服务 的 类 
android. media 提供 了 管理 语音 和 视频 中 的 多 种 媒体 接口 的 类 
android. media, audiofx 提供 了 管理 音频 效果 的 类 

android. media. effect 管理 多 媒体 效果 的 类 


提供 支持 直接 连接 相机 等 设备 的 API, 使 用 MTP( 媒 体 传输 协议 ) 中 的 子 


android. mtp E PTP( 图 片 传输 协议 ), 当 设 备 连接 和 删除 ,管理 存储、 传输 文件 和 元 
数据 时 ,应 用 程序 可 接收 到 通知 
android, net 协助 进行 网 络 存 取 的 类 ,包括 标准 java. net. * 应 用 程序 接口 
android. net. http 支持 Http 协议 的 类 
为 RTP( 实 时 传输 协议 ) 提 供 的 API, 允 许 应 用 程序 管理 点 播 或 交互 式 数 
android. net. rtp 据 流 。 提 供 VoIP、 通 话 、 会 议 、 音 频 流 的 程序 ,可 以 使 用 这 些 API 来 启动 
会 话 , 传 输 或 接收 任何 可 用 的 网 络 数据 流 
android. net. sip 提供 访问 会 话 发 起 协议 (SIP) 的 功能 ,如 使 用 SIP 来 接听 VoIP 电话 
android. net. wifi 提供 了 管理 设备 上 Wi-Fi 功能 的 类 
android. net. wifi. p2p 提供 了 管理 设备 上 Wi-Fi 的 点 对 点 功能 的 类 
提供 访问 近 场 通信 (NEFC) 功 能 ,允许 应 用 程序 在 NFC 标签 中 读 取 NDEF 
android. nfc 消息 
deos. nf tech 这 些 类 提供 了 对 不 同类 型 标签 技术 特征 进行 访问 的 类 ,一 个 标签 可 以 同 
android, nic, tec 时 支持 多 种 技术 
android. opengl 提供 OpenGL 功能 
android. os 提供 设备 上 的 基本 操作 系统 服务 ,消息 路 由 和 进程 间 通 信 
android. os. storage 提供 设备 上 的 基本 操作 系统 的 存储 服务 
android. preference 提供 管理 应 用 程序 性 能 和 执行 UI 参数 选择 的 类 
android. provider 提供 了 方便 的 类 用 来 访问 Android 提供 的 内 容 提供 商 
; n 提供 一 个 底层 ,高 性 能 的 3D 运行 时 框架 ,其 提供 构造 3D 场景 的 API 
android. renderscript 函数 
android. sax 使 写 入 高 效 和 和 鲁 棒 的 SAX 操作 变 得 简单 的 框架 
android. security 提供 安全 功能 的 类 
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包 名 称 说 明 
android. service. textservice | 拼写 检查 器 服务 的 基础 类 
android. service. wallpaper | 提供 墙纸 功能 的 类 
android. speech 提供 扩展 语音 识别 服务 的 基础 类 
android. speech. tts 提供 将 文本 转 成 不 同 语言 音频 输出 的 类 
aoho P A EE 基本 电话 信息 ,比如 网 络 类 型 和 连接 状 
android. telephony. cdma | 提供 了 应 用 程序 接口 用 来 使 用 CDMA 特有 的 电话 性 能 


提供 了 应 用 程序 接口 用 来 使 用 GSM 特有 的 电话 性 能 ,比如 文本 /数据 / 


android. telephony. gsm PDU SMS 消息 

android. test 用 来 书写 Android 测试 实例 的 框架 

android. test. mock 提供 了 多 种 Android 框架 构建 模块 的 工具 类 

android. test. suitebuilder | 支持 测试 运行 类 的 功能 类 

android. text 提供 了 用 来 显示 或 追踪 屏幕 上 文本 和 文本 间距 的 类 

android. text. format 提供 文本 内 容 格 式 化 功能 的 类 

android. text, method 提供 了 用 来 监测 或 修改 键盘 输入 的 类 

android. text. style 提供 了 用 来 显示 或 改变 视图 实体 中 文本 间距 风格 的 类 

了 人 可 点 击 的 链接 并 创建 RFC 822 消息 类 型 (SMTP) 

nionad 提供 了 一 般 的 功能 方法 ,比如 日 期 /时 间 控 制 .64 位 编 解码 器 .字符 串 和 
数字 转换 方法 以 及 XML 功能 

android. view 提供 类 用 来 显示 控制 屏幕 布局 和 用 户 交 互 的 基本 用 户 接口 类 

android. view. accessibility | 用 来 呈现 屏幕 内 容 和 变化 的 类 ,可 以 查询 系统 的 全 局 可 访问 状态 

android. view. animation | 实现 中 间 帧 动画 的 类 

android. view. inputmethod | 用 来 进行 视图 和 输入 方法 (比如 软 键盘 ) 交 互 的 框架 类 

android. view. textservice | 文本 服务 的 类 

android. webkit 提供 了 浏览 互联 网 的 工具 

android. widget 窗口 部 件 包 包含 了 应 用 程序 屏幕 上 使 用 的 UI 元 素 


dalvik. bytecode 


提供 了 围绕 Dalvik 字 节 码 的 类 


dalvik. system 


提供 了 Dalvik VM 特有 的 功能 和 系统 信息 的 类 


附录 C 


ZN 
ADB 命令 
类 A 命令 说 明 
d 指定 adb 命令 发 往 连接 的 USB 设备 (备注 : 如 果 连 接 两 个 或 两 
个 以 上 的 USB 设备 , 则 返回 错误 提示 ) 
参数 - 指定 adb 命令 仅 发 往 运行 的 Android 模拟 器 (备注 : 如 果 有 两 
j i 个 或 两 个 以 上 的 Android 模拟 器 在 运行 , 则 返回 错误 提示 ) 
ww | 指定 adb 命名 链接 的 模拟 器 或 设备 ,模拟 器 或 设备 通过 
ilc CD "emulator- 端 口 " 的 方式 指定 ,例如 emulator-5556 
devices 显示 所 有 链接 的 模拟 器 或 设备 列表 
通用 命令 |help 显示 adb 支持 的 命令 列表 
version 显示 adb 的 版 本 号 
logcat [ < option > ] us 
[< filter-specs ] 打印 日 志 数据 到 屏幕 
调试 命令 bugreport 打印 dumpsys.dumpstate 和 logcat 数据 到 屏幕 ,用 以 报告 错误 
jdwp 显示 指定 设备 的 JDWP 进程 列表 
install 一 path-torapk> | 将 Android 应 用 程序 安装 到 模拟 器 或 设备 
RTT MI Leni 将 模拟 器 或 设备 上 的 指定 文件 ,复制 到 开发 主机 
push local x P » 
将 开发 主机 上 的 指定 文件 ,复制 到 模拟 器 或 设备 
— remote-- 
forward local 将 本 地 端口 的 Socket 链接 的 数据 转发 到 指定 的 远程 模拟 器 或 
<remote> 设备 端口 
在 USB 上 运行 PPP， 
络 与 端口 
eq M VN <tty>— uy 是 操作 PPP 流 的 命令 . 
M Lpa, ds 示例 : dev: /dev/omap csmi ttyl. 
parm]--- 


[parm]... —0 个 或 更 多 PPP/PPPD 选项 ， 
比如 默认 路 由 ,本 地 ,notty 等 
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续 表 
类 E 命 令 说 明 
get-serialno 显示 adb 链接 的 模拟 器 或 设备 的 序列 号 
脚本 命令 get-state 显示 adb 链接 的 模拟 器 或 设备 的 状态 
wait-for-device 阻止 程序 运行 ,等 待 设备 就 绪 
start-server 检查 adb 服务 进程 是 否 运行 ,如 果 未 启动 , 则 启动 之 
服务 器 命令 
kill-server 终止 adb 服务 进程 
shell 针对 目标 模拟 器 或 设备 启动 一 个 远程 Shell 
Shell 命令 “| shell[ 二 shellCommand | 针对 目标 模拟 器 或 设备 启动 一 个 Shell, 并 直接 执行 Shell 命令 


>] 


<shellCommand> 


附录 D 


AndroidManifest 文件 


每 个 Android 应 用 程序 都 有 一 个 AndroidManifest. xml 文件 ,用 以 在 程序 运行 前 向 
Android 系统 声明 程序 的 相关 信息 ,这 些 信 息 包括 应 用 程序 的 命名 空间 、 模 块 组 成 .宿主 
进程 .许可 .最 低 SDK 版 本 ,程序 运行 所 需要 连接 的 函数 库 等 。 

AndroidManifest. xml 文件 主要 由 元 素 、 属 性 和 类 声明 等 重要 部 分 组 成 。 在 
AndroidManifest. xml 中 ,多 数 元 素 的 出 现 次 数 没有 限制 ,而 且 在 同一 层次 的 元 素 没 有 顺 
FF EK . [f] Vl < activity >, < provider > fI < service > JÈ Z T VA fi 4E fap Jii Fs He 9. fH. 
— manifest fl — application" 75 X H fiÉfE AndroidManifest. xml 中 出 现 一 次 ,而 且 必 须 


出 现 一 次 。 


AndroidManifest. xml 文件 的 元 素 与 属性 关系 参考 表 D. 1 ,通用 结构 如 下 所 示 。 


1 
2 
3 
4 
5 
6 
y 
8 
9 


«application» 


«activity» 
< intent- filter» 
<action/> 


<?xml version- "1.0" encoding- "utf- 8"?> 
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21 < category/> 

2 <data/> 

23 « /intent- filter» 

24 <meta- data/> 

25 < activity» 

26 

27 «activity- alias» 

28 < intent- filter» ..« /intent- filter» 
29 <meta- data/» 

30 < /activity- alias» 

3l 

32 < serviœ> 

B < intent- filter» ..« /intent- filter» 
A <meta- data/> 

35 < /servioe» 

36 

37 «receiver» 

38 < intent- filter» ..« /intent- filter» 
39 <meta- data/> 

40 < /receiver» 

4l 

42 «provider» 

43 « grant- uri- permission/» 
44 <meta- data/> 

45 < /provider» 

46 

4 « uses- library/» 

48 

49 < /application» 

50 

51  «/manifest^ 


在 通常 情况 下 ,元 素 的 属性 是 用 来 描述 如 何 解释 元 素 内 容 , 一 般 都 是 可 以 省 略 的 。 
但 在 AndroidManifest. xml 中 ,为 了 使 元 素 具有 意义 ,一 些 特定 的 属性 是 不 能 够 省 略 的 ， 
例如 二 manifest 二 元 素 的 二 xmlns:android 二 属性 和 二 package 二 属性 。 如 果 需 要 为 同一 
个 元 素 的 属性 指定 多 个 值 , 则 需要 重复 书写 这 个 元 素 ,书写 方法 如 下 所 示 。 
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< intent- filter..> 
< action android:name- "android. intent .action.EDIT"/> 


< action android:name- "android. intent.action.DELETE"/» 


1 
2 
3 < action android:name- "android. intent.action.INSERT"/» 
4 
5 
6 


< /intent- filter» 


许多 元 素 的 定义 需要 声明 类 名 ,例如 所 activity 二 二 service 二 和 志 receiver 二 等 元 
素 。 如 果 在 直接 通过 android:name 属性 声明 类 名 , 则 声明 的 类 名 必须 包含 完成 的 包 名 
称 。 但 如 果 在 二 manifest 二 元 素 中 使 用 了 二 package 二 属性 , 则 可 以 在 android: name 属 
性 声明 类 名 时 不 包含 完整 的 包 名 称 。 区 别 可 以 参考 下 面 的 两 段 代码 。 


完整 类 名 : 
1 <manifest..> 
2 < application.» 
3 < service android:name- "edu.hrbeu.ServioceDemo.MyService".. 
4 三 
5 < /service> 
6 m 
7 < application» 
8 < /manifest^ 
简化 类 名 : 


«manifest package- "edu.hrbeu.ServiceDemo "..> 
«application..^ 
< service android:name- ".MyService".. 


< /service» 


< /application> 
< /ranifest> 
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spopyindupjosAoputa : pro3pue 
suondOm : proxpue 
3uir 


PapaaNloNale1s:PIOIPUP 
UonB uH Us + prorpue 
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$$3201d : pio1pue 


uorssmuad : pio3pue 
A 5 K10181 HOU : pio3pue 
i x AIADDV fif 5 e" ME PEE 
212 Ss us sso2o1dn[nur: pro3pue USD " ; 
Ms "a . apojquouney : pro3pue «c uonvordde — <name> 
u fi HEK 
E 101puv 
Ap2V Anoy 4 — Hiat po119|922 y 21€ A piu: pro1pue 
ypuneqyse [ u()ugsiur : pro1pue 


poxiodxo: proapue 

sua ywo [o pn]ox o 3 pro1pue 
Paelqeua PIOIPUP 
sagueUD3Uuoo:PIOIPUP 
qouneTu()xs? L122 


3108s» [ urzjos[SA eA] 
Sunuo1edos[ys? [ ^o[[e : propue 


Eg cuonoe- 
VE V9 qx 
«pg —3uaut > —* Sgt 
F wau [gg uonoe y — if Br 


Woo H *boD Bí fu * x oz * 
REHAL p lsaJIueINPIOpPuV T'A% 


oumu:pro1pue Nau > uone > 


IR 
A 


*x r 
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suond(jmn : proxpue 

auia: pro1pue 
Ayurjjy3se1: propue 
UOISI2 A Au 310]831: plo1pue 
ssaooud: pio1pue 


juojsis1od : 


tupu: pioipue 


<AIBIq1l-Sasn > 


34 6 4) Hz A&yAnoyooedgosieugur: po3pue 一 I9pIAoId > 
E Mf e Z8 Y fer Ul 4) HEG H FE ET prompte | o M Jueu uonealdde > 
BEC fy Ha tt han "popue A Lis 
T) 3E QC EET BTE MoM I PIodpus «sene-&mnnoe > 
Uoot: popu «Anno > 
uondruosop: pro1pue 
alde33nqap :pioipue 
yuə3ydnyəLq + piorpue 
Bunuəredəyyse [ ^O[[? : pro1pue 
Kano yiosize): pro1pue 
ruad : pro1pue 
ty dut) gra sp AIAnoV198 oureu:pto1pue 
-IB1 iprorpue HH gj * Ne Gd ]9q*[: pro1pue Rp e «c uonvordde > «svi[e-aranoe > 
AlIAHOV Ff < sepo- Arno? > uoot: pioipue al c a 
paliodxa :prioipue 
po[quuo: pro1pue 
Wo ou 3h EE BÍ fu *X x oz 于 xox x x 


E 
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X2 
Ly it ep tl — 1082192 — «194192817 
aiat > e J4- Hi X d up <as> 
M — 学 一 AI038slp5 二 E 一 yya 
SERCREOR AM Cose vovit IMMER) -uonos— «seqe-Aranos s. 
GH Xp ZEE ZE DEM e A Z g : 一 AIADnoe 二 
CES m e gp nov Rc 
aaeypedla31e1:pIOIPue 
auBU:PIOIPUP 
TCR ]9qu[:pioipue . , 
proipuy f (sy pf H SEXE uoot: plozpug «as9gneur-. uoneyuawunnsul > 
H ‘g uonviusumagisu] [fi s Suyjorgo]pueq: propue 
1s9 [ [euonounj : prospue 
xijo1quied : popu 
Hoo E HERE DA urelleddled:pIoIpue 一 IapIAold 二 一 uoISSIUUI9d-IIn-1UBI3 > 
E E EE EREL nk cis 
auuaUos:PIOIPUP 
T 10d: pro1pue 
SH nin 1 xyərqgyed :priorpue 
E SE HPR EE YA Mu "T W ualledUled:pIorpue <ua emp 
(SE 3 ERE AERE dr RE YA D Efi Nee 
AL HP DEL s ie TE nonu fc i 
1sog:prorpue 
FOE PE Aysuo(quaa15s : propue i 2 2 
出 而 m x 2d Gy E "m nm Hk aziguao1os " pioipuv Ksa jueu > <suəəns-əjquedwo > 
x um uL 2uru:pro1pug «aemauejur <Á1033 > 
Wo o8 3h EE BÍ Du x x or * x ox x x 
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]9Ae quon22301d : pro1pue 
dno1cjuorssmuad : pro1pue 


EERTE T2464 ee 
BHAI ARR BERT SE ERR asopumu > <uorsspurd> 
MKH Jn 4 326 is uon 
uonduosap:prozpue 
UOISSTULIO goym ? pro1pue 
SHIBSE REA REIR 42 worsspuniaqpeoa spioapue 
BEAUX 3 Je HERE uotssturad +proxpuv e 
I BE RH d d 1o prao1qniuo1u07) uiojequied: proipue ppor a 
AE Ub EE RE xgJexdqled:pPlorpue 
qied:proipue 
HLE . «19A19921 > 
一 Bep-Blau — Jp 4 CX YA fu anlea : pro1spue anu 


Xx fy Cis se HE GU E 
CM SE C 25 Be M BY D fi 
KR FO AE E MÉCRE 


321n0s21: pro1pue 
oureu: pro1pue 


«CSVI[e-A3A T2? > 


一 Bep-elau 二 


FA M GUT Ie PIOTPUV + suwx 
34 HF J£ * 3E ac —uonvoirddv — 


uoneoo'Tpeisur: proipue 


SUIeNUOISJ3A + pro1pue 


apojuors12A : pio1pue 


一 Ps-sasn 二 
«uorssimuad-sasn — 
«cuornansirjuoo-sasn — 
«9211-uorssruniad > 


g pqeqasn peys : po1pue < 1s9jluew > 
y 9WIET aw priospipoaeus : pro1pue amorato dm 
HHX Wx 3saJrueJINPIOIPUV im udi «cuoissruLiad > 
" NOLAN uonauawunnsul > 
FESP I CHM E f.) cuoneordde 7. 
wo B ybi Bí fu X X x X 3X 3 *x x 
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UoISSsIuuIadelUA : po1pue 
a[qeouás: pro1pue 
uoisstuLiag pea1 : pro3pue 
ssəə01d : pio1pue 
uoissruriad : pro3pue 


EN w BaUUBU: pro1pue " d d 
E SE M E E RW S SE Prop sasooidpinurtpiospue uorssturad-q1ed > 
-UV [yj g xac r9prao1d — «c uoissmuad-un-1uv13 > uonealdde > 19piA01d > 
lk Efa N m SE E E H 一 Bep-elatu 二 
XE Md M fp RE RE SER Hd 
suoissmuagqu nueg pro1pue 
pourodxo:pro1pue 
pe[quua: pro1pue 
soniuogine: pro1pue 
Tr 3 6 E DI SE cb f f t Fol ie eumd 
Xy [f ( ) uorssmuragppe “198eu iv. 
一 1sajrupuu 一 一 aaH-uotssruled 一 
-aasebed FERGA BEH jie à 
T * 4 2: BS DL fo Jur t aed i 
d " DA 9umu:pro1pue 
34 B( dnoijuorssmuded. 了 并 中 qoos] ipiospue 
X ac «c uorssured > FE Br fu woorpiospue «asogmur-. < dnoi8-uorssruuad > 
MWST WN fy tg Ha Ay a uonduosap:propue 
VK E qn dA 68 3€ HEB? — 8c 
E Li *b mp Ri fu x x t ¥ x x x ac 
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duurTq pr saBrel: pro1pue 
daatruurTdpIAalqneduuoo:pIorpue 


FMAHÁGHEOE| a Mice iA 
qmipiAAisallewuSsannbar: proipue 
H R CER ETC REEE AlISUaGAUB:PIOIPUP 
pb BERE ER bbs suaa19gos1v|x :proipue Jueu < 一 SUaalIos-SlI0ddns 二 
* xm SEX MTH mH m% suao10goS1v[: proxpue 
CY IRE SEE EIE EH jen + SUaaIOSTeuuIoU:PIOIPUP 
ABE EEEE TIEL] akon uus 
a[quozisa1: pro1pue 
Ye dns 49 93urgu:pro1pue jsaprugur s: s 
ipt 1 S» 21njx23-]3-s110ddns > 
ode Gb ARX AERE BERT aii ic icis 
IdV fl $s2201d :prioipue 
Hf sE k BRUNCH T o uorssruized : prozpue 
Api BL D SEESE KEEK Siue pIOspus cu DUIS 
出 soot eS ^ pLEE el EH GH NE fr Ilaqel:proipue ST «cuoneordde — «991498 > 
Hj 3j soot * [u| p. sontanoy uooriproipue «ng v 
和 与“ 缴 士 eolAIeS X6 DMS fil pouiodxo:proipue 
A) Ei HERE EH TL EE Hl — Ht nf pargeto propre 
- E $s2201d : proipuv 
E MEIRE A GH I SE 2H uoissruLiad : pro3pue 
8 : Bep-eawu > 
i aqe[:PIOIPUe uoneordde 19419991 
2a Acropora pisces <Ja Soe e E - 
ER EE RM XEB ERE- po1jodxo: pro1pue 
EE DEEE ME peratia pronpos 
wo 8H yhp Bí fu * x £z x ry x r 
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UOISI9 AxpSxeur: 


TUYED F de eA UOISI9A MAPS1331p1: Jueu 二 一 ps-sasn 二 
CR se pru BE BER Hal UOISI9AXpSurur: proipue 
"TERTERET] "s z z auueu:pIOIPUP 一 1Sejrueuu > 一 UoISsIUIed-sasn 二 
HRK SA GU REGE 
HARG pro1puy i m Paxrtnbar:pIorpue 
工 <hrerqtLsasn> a E E Do <uonealldde > 一 AIBIqI[-Sasn — 
HE GA E SHEET EC EH TE Bt af 
a UOISI9AS313:PIOIPUP 
Wke A NE R TE Paxtnpar:PIOIPUP 一 1SejIueu > 一 9InlBej-Sasn > 
e LI CREARI M n idend 
uaa1oguono [ baz : pro1puv 
mom -uoneslaeNbar : pro1pue 
-ad& [ p1eoqáəybə1 : pioipue 一 1SejIUBUU > < 一 UODBIn8UJuoo-Ssasn > 
38 8026 28 LE SERRE DUET s ipseque pre os 
-ABNAB paat [bar i pro1pue 
TO H yhp Bi fu a6 ¥ x ox * ax 
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